Manuals / Compaq / Computer Equipment / Computer Accessories

Compaq AAPVNFGTE manual Acmsdigetversion, Version Type char * Access write

Models: AAPVNFGTE

1 140

Download 140 pages 48.31 Kb

Page 77

acmsdi_get_version

3.12.2 acmsdi_get_version

The TP Desktop Connector gateway calls this routine on the OpenVMS system whenever it receives an ENABLE request from the EXC. The action routine can return a version string that is then passed to the desktop client program, allowing a version comparison at the desktop system.

This service can also be used in a forced nonblocking environment, see Section 4.3. On a Windows system, version checking occurs during enable processing.

Format

acmsdi_get_version (form_ﬁle, version)

Parameters

form_ﬁle Type: char * Access: read

Mechanism: by reference

Form ﬁle or request library speciﬁcation from the ACMS task group deﬁnition.

version Type: char * Access: write

Mechanism: by reference

Twenty-four bytes in which the routine writes the version number or date associated with the speciﬁed form ﬁle. The version parameter is passed to the desktop client program to be checked in the acmsdi_check_version routine.

Return Status

Always returns SUCCESS status.

Portable API Presentation Procedures 3–27

Image 77

Compaq AAPVNFGTE manual Acmsdigetversion, Version Type char * Access write

Contents

May Revision Update InformationOperating System Software VersionPage Contents Forced Nonblocking Client Services Portable API Presentation ProceduresData Compression Monitor Commands System Management Service on OpenVMSCompaq Acms System Status Values Index Examples Exit Help List Renew Select SET ShowTables FiguresManual Structure Intended AudienceRelated Documents ChapterDescriptionCompaq Acms for OpenVMS Introduction User Input ConventionsPage Routine Names Services Description ParametersFormat ParametersData Type Description Type EntryParameter Data Types Called Routine Access Methods AccessAccess Method Description MechanismParameter-Passing Mechanisms Return StatusSession Environments Matrix of Services and Environments Callbacks Cont. Matrix of Services and EnvironmentsCont. Matrix of Services and Environments Page Service Description Summary of Portable API Client ServicesSummary of Portable API Client Services Cont. Summary of Portable API Client Services Nonblocking Service UsageServiceDescription Parameter Memory AllocationParameters Nonblocking and Blocking RestrictionCompletion Routine Format Workspace Data Structures Callcontext Type void * Access read Mechanism by valueAcmsdiworkspace Structure and Initialization Macro Return StatusExample 2-1 Workspace Structure Deﬁnition and Initialization Example 2-2 Passing Workspaces to a ProcedureExample 2-4 Passing Two Workspaces Acmsdiworkspaceopt StructureExample 2-3 Acmsdiworkspaceopt Type Deﬁnition Example 2-4 Cont. Passing Two Workspaces Acmsdiworkspacebind StructureAcmsdiformrecordbind Structure 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ﬁerFormat AcmsdicalltaskParameters SubmitteridTaskname Type char * Access read Mechanism by reference Callid Workspacecount Type long int Access read Mechanism by valueWorkspaces Acmsdicalltask Return Status Values Return StatusCompletionroutine 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 ValuesStatusDescription AcmsdidispatchmessageAcmsdidispatchmessage Return Status Values Cont. acmsdidispatchmessage Return Status Values Acmsdireturnpointer Structure Type long int Access read Mechanism by referenceAcmsdisignin Username Type char * Access read Mechanism by referencePassword Type char * Access read Mechanism by reference Submitterid OptionsAcmsdisignin Return Status Values Format AcmsdisignoutAcmsdisignout Return Status Values Callcontext Type void * Access read Mechanism by valueAcmsdisignoutactv Cont. acmsdisignout Return Status ValuesPage Customer-Supplied Procedure Description Summary of Portable API Presentation ProceduresSummary of Portable API Presentation Procedures 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 Version Type char * Access read Formﬁle Type char * Access readVersion-Checking Routines Acmsdicheckversion26Portable 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 referenceAcmsdiinternal Acmsdimixedmode Acmsdinomemory Acmsdiready 13 acmsdipoll Return Status ValuesAcmsdirecvexch Acmsdirequestexch13 Cont. acmsdipoll Return Status Values System Management Service on OpenVMS Usercontext ACMSDI$GETSUBMITTERINFOSubmitter Information Item Codes ItmlstACMSDI$KLATESTMSGTIME Code NameACMSDI$KDESKTOPID Cont. Submitter Information Item CodesACMSDI$KNODENAME ACMSDI$KSIGNINTIMEACMSDI$KTRANSPORT ACMSDI$KSUBMITTERIDACMSDI$KUSERNAME TargetsubmitterIDACMSDI$GETSUBMITTERINFO Return Status Values TargetusernameData Compression Monitor Commands Format ExitHelp Qualiﬁers ListAPPLICATION=application BEFORE=date-timeOUTPUT=ﬁle NODE=node-identiﬁerSINCE=date-time TASK=task-nameUSER=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