Manuals / Compaq / Computer Equipment / Computer Accessories

Compaq AAPVNFGTE Version-Checking Routines, Acmsdicheckversion, Formﬁle Type char * Access read

Models: AAPVNFGTE

1 140

Download 140 pages 48.31 Kb

Page 75

acmsdi_check_version

3.12 Version-Checking Routines

The following sections describe the version-checking routines. Version checking is supported on systems using FORM I/O tasks (see Compaq TP Desktop Connector for ACMS Client Application Programming Guide).

3.12.1 acmsdi_check_version

TP Desktop Connector client services call this routine whenever they receive an ENABLE request from the TP Desktop Connector gateway. The action routine can check the version string passed from the acmsdi_get_version routine on the submitter node and notify the desktop user of any inconsistency.

You request version checking during a sign-in (see Compaq TP Desktop Connector for ACMS Client Application Programming Guide).

Format

acmsdi_check_version (form_ﬁle, version)

Parameters

form_ﬁle Type: char * Access: read

Mechanism: by reference

Speciﬁcation of a form ﬁle or a request library from the ACMS task group deﬁnition.

version Type: char * Access: read

Mechanism: by reference

Twenty-four bytes containing the version number or date supplied by the acmsdi_get_version routine on the OpenVMS system.

Portable API Presentation Procedures 3–25

Image 75

Compaq AAPVNFGTE manual Version-Checking Routines, Acmsdicheckversion, Formﬁle Type char * Access read

Contents

Software Version Revision Update InformationMay Operating SystemPage Contents Forced Nonblocking Client Services Portable API Presentation ProceduresExit Help List Renew Select SET Show System Management Service on OpenVMSData Compression Monitor Commands Compaq Acms System Status Values Index ExamplesTables FiguresChapterDescription Intended AudienceManual Structure Related DocumentsCompaq Acms for OpenVMS Introduction User Input ConventionsPage Parameters Services Description ParametersRoutine Names FormatType Entry Parameter Data TypesData Type Description Mechanism AccessCalled Routine Access Methods Access Method DescriptionReturn Status Session EnvironmentsParameter-Passing Mechanisms Matrix of Services and Environments Callbacks Cont. Matrix of Services and EnvironmentsCont. Matrix of Services and Environments Page Summary of Portable API Client Services Summary of Portable API Client ServicesService Description Parameter Memory Allocation Nonblocking Service UsageCont. Summary of Portable API Client Services ServiceDescriptionNonblocking and Blocking Restriction Completion Routine FormatParameters Return Status Callcontext Type void * Access read Mechanism by valueWorkspace Data Structures Acmsdiworkspace Structure and Initialization MacroExample 2-1 Workspace Structure Deﬁnition and Initialization Example 2-2 Passing Workspaces to a ProcedureAcmsdiworkspaceopt Structure Example 2-3 Acmsdiworkspaceopt Type DeﬁnitionExample 2-4 Passing Two Workspaces Acmsdiworkspacebind Structure Acmsdiformrecordbind StructureExample 2-4 Cont. Passing Two Workspaces Acmsdicalloption Union Structure Option Description OptionConstant Description Acmsdioption ArrayVoid *mymallocroutineint size long pwdexpbuffer Example 2-5 Initializing an Options ListInt status Example 2-6 Dynamically Specifying a TCP/IP Port IdentiﬁerSubmitterid AcmsdicalltaskFormat ParametersTaskname Type char * Access read Mechanism by reference Workspacecount Type long int Access read Mechanism by value WorkspacesCallid Return Status CompletionroutineAcmsdicalltask Return Status Values Cont. acmsdicalltask Return Status Values Cancelreason Type long int Access read Mechanism by value AcmsdicancelCallcontext Type void* Access read Mechanism by value Reserved Type Access MechanismAcmsdicancel Return Status Values Acmsdicompletepp Ppstatus Type long int Access read Mechanism by valueAcmsdinoppactv Acmsdicompletepp Return Status ValuesAcmsdidispatchmessage Acmsdidispatchmessage Return Status ValuesStatusDescription Cont. acmsdidispatchmessage Return Status Values Acmsdireturnpointer Structure Type long int Access read Mechanism by referenceUsername Type char * Access read Mechanism by reference Password Type char * Access read Mechanism by referenceAcmsdisignin Submitterid OptionsAcmsdisignin Return Status Values Format AcmsdisignoutAcmsdisignout Return Status Values Callcontext Type void * Access read Mechanism by valueAcmsdisignoutactv Cont. acmsdisignout Return Status ValuesPage Summary of Portable API Presentation Procedures Summary of Portable API Presentation ProceduresCustomer-Supplied Procedure Description Cont. Summary of Portable API Presentation Procedures Return Status Values Expected from Presentation ProceduresExample 3-1 Form Record Deﬁnition and Initialization Macro Acmsdiformrecord Structure and Macro CallBlocking and Nonblocking Usage Presentation Procedures in a Nonblocking EnvironmentFormssession AcmsdidisableSubmitterid AcmsdienableFormsprintﬁle Type char * Access read Mechanism by reference 8Portable API Presentation Procedures Acmsdireadmsg Prompttext Type char Access read Mechanism by reference10Portable API Presentation Procedures Receiverecordidentiﬁer Type char AcmsdireceiveReceivecontroltextcount Type long int TimeoutReceiverecord Return StatusAcmsdirequest Requestname Type char * Access read Mechanism by referenceWorkspaces Acmsdisend Sendrecordcount Type long int Access read Mechanism by valueReceivecontroltextcount Type long int Sendrecord Return StatusFormat Acmsditransceive20Portable API Presentation Procedures Timeout 22Portable API Presentation Procedures Format Acmsdiwritemsg24Portable API Presentation Procedures Acmsdicheckversion Formﬁle Type char * Access readVersion Type char * Access read Version-Checking Routines26Portable API Presentation Procedures Acmsdigetversion Version Type char * Access writePage Summary of Forced Nonblocking Procedures Summary of Forced Nonblocking ProceduresAcmsdiformrecordbind Structure Cont. Summary of Forced Nonblocking ProceduresExample 4-2 Workspace Structure Deﬁnition Example 4-1 Form Record DeﬁnitionFormat AcmsdicompletecallType Acmsdiworkspace or Acmsdiworkspaceopt array Acmsdicompletecall Return Status Values Return StatusFormat AcmsdibindenableargsCallid Formversion Type char * Access write Mechanism by referenceAcmsdiwrongbind Acmsdibindenableargs Return Status ValuesDirection AcmsdibindmsgText LengthStatus Description Acmsdibindmsg Return Status ValuesFormat AcmsdibindreceiveargsAcmsdibindreceiveargs Return Status Values TimeoutReceiverecord AcmsdibindreceiverecsAcmsdibindreceiverecs Return Status Values Acmsdibindrequestargs Requestname Type char * Access write Mechanism by referenceAcmsdibindrequestargs Return Status Values CallidDirection AcmsdibindrequestwkspsAcmsdibindrequestwksps Return Status Values Formssession AcmsdibindsendargsAcmsdibindsendargs Return Status Values TimeoutSendrecord Acmsdibindsendrecs10 acmsdibindsendrecs Return Status Values Formssession Acmsdibindsessionid11 acmsdibindsessionid Return Status Values Acmsdibindtransceiveargs 28Forced Nonblocking Client Services 12 acmsdibindtransceiveargs Return Status Values Return StatusAcmsdipoll Callcontext Type void * Access write Mechanism by referenceAcmsdirequestexch 13 acmsdipoll Return Status ValuesAcmsdiinternal Acmsdimixedmode Acmsdinomemory Acmsdiready Acmsdirecvexch13 Cont. acmsdipoll Return Status Values System Management Service on OpenVMS Usercontext ACMSDI$GETSUBMITTERINFOCode Name ItmlstSubmitter Information Item Codes ACMSDI$KLATESTMSGTIMEACMSDI$KSIGNINTIME Cont. Submitter Information Item CodesACMSDI$KDESKTOPID ACMSDI$KNODENAMETargetsubmitterID ACMSDI$KSUBMITTERIDACMSDI$KTRANSPORT ACMSDI$KUSERNAMEACMSDI$GETSUBMITTERINFO Return Status Values TargetusernameData Compression Monitor Commands Format ExitHelp BEFORE=date-time ListQualiﬁers APPLICATION=applicationTASK=task-name NODE=node-identiﬁerOUTPUT=ﬁle SINCE=date-timeUSER=user-identiﬁer ExamplesSelects all records for task calls from node ALPHA1 19. /USER=MAIN-PLANT Renew ﬁle SelectNODE=node-identiﬁer 12Data Compression Monitor Commands Format SET14Data Compression Monitor Commands Show Page Table A-1 Acms System Status Values Symbol Value TextTable A-1 Cont. Acms System Status Values Compaq Acms System Status Values A-3 Page Index-1 IndexIndex-2 Index-3 Index-4