Manuals / Compaq / Computer Equipment / Computer Accessories

Compaq AAPVNFGTE manual Length, Text

Models: AAPVNFGTE

1 140

Download 140 pages 48.31 Kb

Page 89

acmsdi_bind_msg

from ACMS. A value of 0 indicates that the message text for a TDMS Read exchange is being copied to ACMS from the application’s memory.

length

Type: short int

Access: read

Mechanism: by value

The length of the text being sent or the length of the buffer to receive the text; speciﬁcally one of the following:

•the length of the buffer in the application’s memory which is to receive the prompt text for a TDMS Read exchange.

•the length of the message text being sent to ACMS for a TDMS Read exchange.

•the length of the buffer in the application’s memory which is to receive the message text for a TDMS Write exchange.

text

Type: char

Access: read/write

Mechanism: by reference

The text string being sent to ACMS or the buffer which is to hold the text string being acquired from ACMS.

call_id

Type: ACMSDI_CALL_ID *

Access: write

Mechanism: by reference

Pointer to the call identiﬁcation returned by the acmsdi_call_task service. To identify the original task call, compare this pointer with a reference pointer to the call identiﬁer obtained by acmsdi_return_pointer.

Return Status

This function returns an int value representing a valid TP Desktop Connector status code as deﬁned in ACMSDI.H and described in Table 4–4.

Forced Nonblocking Client Services 4–11

Image 89

Compaq AAPVNFGTE manual Length, Text

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