background image

Option

Description

ACMSDI_CALL_OPT_END_LIST

Ends options list

ACMSDI_CALL_OPT_OPTIMIZE_WKSPS

Enables unidirectional workspace
optimization

ACMSDI_CALL_OPT_ENABLE

Pointer to enable function

ACMSDI_CALL_OPT_DISABLE

Pointer to disable function

ACMSDI_CALL_OPT_SEND

Pointer to send function

ACMSDI_CALL_OPT_RECEIVE

Pointer to receive function

ACMSDI_CALL_OPT_TDMS_READ

Pointer to TDMS read function

ACMSDI_CALL_OPT_TDMS_WRITE

Pointer to TDMS write function

ACMSDI_CALL_OPT_TRANSCEIVE

Pointer to transceive function

ACMSDI_CALL_OPT_REQUEST

Pointer to TDMS request function

ACMSDI_CALL_OPT_CHECK_VERSION

Version checking routine

ACMSDI_CALL_OPT_PASS_TID

TID of distributed transaction

ACMSDI_CALL_OPT_COMPRESS_WKSPS

Activate workspace compression

To select options:

1.

Declare an array of at least two elements of the type ACMSDI_CALL_
OPTION.

2.

Specify in the option variable the name for the structure being used.

3.

Specify the address for the malloc routine or password expiring buffer, if
these options are being used.

4.

End an options list by assigning ACMSDI_CALL_OPT_END_LIST to the
option variable in the last array element.

The following example shows the initialization of an options list used to enable
unidirectional workspace handling:

ACMSDI_CALL_OPTION call_options[2];

call_options[0].option = ACMSDI_CALL_OPT_OPTIMIZE_WKSPS;
call_options[1].option = ACMSDI_CALL_OPT_END_LIST;

TP Desktop Connector Portable API Client Services 2–9

Summary of Contents for TP Desktop Connector AA-PVNFG-TE

Page 1: ...ervices and commands needed to create and maintain TP Desktop Connector client programs that use the portable API Revision Update Information This is a revised manual Operating System Compaq OpenVMS V...

Page 2: ...eir respective companies Confidential computer software Valid license from Compaq required for possession use or copying Consistent with FAR 12 211 and 12 212 Commercial Computer Software Computer Sof...

Page 3: ...cking Service Usage 2 2 2 3 1 Nonblocking and Blocking Restriction 2 3 2 3 2 Completion Routine Format 2 3 2 4 Workspace Data Structures 2 4 2 4 1 ACMSDI_WORKSPACE Structure and Initialization Macro 2...

Page 4: ...6 acmsdi_read_msg 3 9 3 7 acmsdi_receive 3 11 3 8 acmsdi_request 3 14 3 9 acmsdi_send 3 16 3 10 acmsdi_transceive 3 19 3 11 acmsdi_write_msg 3 23 3 12 Version Checking Routines 3 25 3 12 1 acmsdi_che...

Page 5: ...MS System Status Values Index Examples 2 1 Workspace Structure Definition and Initialization 2 5 2 2 Passing Workspaces to a Procedure 2 5 2 3 ACMSDI_WORKSPACE_OPT Type Definition 2 6 2 4 Passing Two...

Page 6: ...dures 3 1 4 1 Summary of Forced Nonblocking Procedures 4 1 4 2 acmsdi_complete_call Return Status Values 4 6 4 3 acmsdi_bind_enable_args Return Status Values 4 9 4 4 acmsdi_bind_msg Return Status Valu...

Page 7: ...3 4 and 5 Contain the reference information on TP Desktop Connector client services presentation procedures action routines and the Compaq OpenVMS based system management service Chapter 6 Lists the d...

Page 8: ...ns Describes procedures to follow using the Application Development Utility ADU Compaq ACMS for OpenVMS Writing Server Procedures Describes how to write and debug procedures for ACMS applications Also...

Page 9: ...ent on your system Return A key name in a box indicates that you press that key on the keyboard Ctrl x Press the Ctrl control key and hold it down while pressing the specified key indicated here by x...

Page 10: ...ellipsis in an example means that information not directly related to the example has been omitted Windows When used alone Windows indicates any supported member of the family of Microsoft Windows ope...

Page 11: ...eclared for the portable API in the include file ACMSDI H in the ACMSDI COMMON directory Square brackets indicate optional parameters in the call 1 3 Parameters This section contains details about eac...

Page 12: ...H include file see Section 2 11 ACMSDI_WORKSPACE Array of structures defined in the ACMSDI H include file to pass workspaces between the desktop system and the TP Desktop Connector gateway see Sectio...

Page 13: ...d in Table 1 3 Table 1 3 Called Routine Access Methods Access Method Description Read Data needed by the called routine to perform its operation is read but not returned Write Data that the called rou...

Page 14: ...as follows Platform Value Windows long int OpenVMS long int Tru64 UNIX long int Only the status codes defined in the related reference sections are valid in the TP Desktop Connector client services Th...

Page 15: ...ch you can use each call Table 1 5 Matrix of Services and Environments Service Availability within Environment Blocking Nonblocking Forced Nonblocking acmsdi_call_task See description in Section 2 6 y...

Page 16: ...d_session_id See description in Section 4 11 yes acmsdi_bind_send_recs See description in Section 4 10 yes acmsdi_bind_receive_recs See description in Section 4 6 yes acmsdi_bind_request_wksps See des...

Page 17: ...g Nonblocking Forced Nonblocking Callbacks acmsdi_transceive See description in Section 3 10 yes acmsdi_write_msg See description in Section 3 11 yes acmsdi_check_version See description in Section 3...

Page 18: ......

Page 19: ...twork communications Table 2 1 summarizes the TP Desktop Connector portable API client services Table 2 1 Summary of Portable API Client Services Service Description acmsdi_call_task Sends a request t...

Page 20: ...by reference Workspaces are passed as structures composed of a length and a pointer field 2 2 Parameter Memory Allocation The caller of a TP Desktop Connector client service or a presentation procedu...

Page 21: ...locking session with the acmsdi_ sign_in service by using the ACMSDI_OPTION ACMSDI_OPT_NONBLK Do not specify a completion routine in a forced nonblocking session as this will result in an error See Ch...

Page 22: ...Structures This section describes the following workspace data structures ACMSDI_WORKSPACE ACMSDI_WORKSPACE_OPT ACMSDI_WORKSPACE_BIND ACMSDI_FORM_RECORD_BIND 2 4 1 ACMSDI_WORKSPACE Structure and Init...

Page 23: ...ssing Workspaces to a Procedure ACMSDI_WORKSPACE wksp_array 2 struct char ctrl_key 5 char error_message 80 control_wksp struct int id_number char first_name 15 char last_name 25 employee_record ACMSDI...

Page 24: ...Type Definition define ACMSDI_ACCESS_READ 1 read only access define ACMSDI_ACCESS_WRITE 2 write only access define ACMSDI_ACCESS_MODIFY 3 modify read and write typedef char ACMSDI_ACCESS_TYPE typedef...

Page 25: ...n the acmsdi h file typedef struct unsigned int buffer_len length of caller s buffer unsigned int wksp_len actual length of the workspace void data ACMSDI_WORKSPACE_BIND 2 4 4 ACMSDI_FORM_RECORD_BIND...

Page 26: ...int buffer_len length of caller s record buffer unsigned int rec_len actual length of the form record void data_record unsigned int shadow_buffer_len length of caller s shadow buffer unsigned int sha...

Page 27: ...ing routine ACMSDI_CALL_OPT_PASS_TID TID of distributed transaction ACMSDI_CALL_OPT_COMPRESS_WKSPS Activate workspace compression To select options 1 Declare an array of at least two elements of the t...

Page 28: ...ient service The include file ACMSDI H contains the definition for the ACMSDI_OPTION array The ACMSDI_OPTION array is a union containing multiple structures and an option variable the value of which d...

Page 29: ...ption ACMSDI_OPT_MALLOC_ROUTINE options 1 malloc_routine address my_malloc_routine options 2 option ACMSDI_OPT_FREE_ROUTINE options 2 free_routine address my_free_routine options 3 option ACMSDI_OPT_P...

Page 30: ...0 ACMSDI_OPTION options 2 options 0 option ACMSDI_OPT_COMMID options 0 CommID tcpip_port options 1 option ACMSDI_OPT_END_LIST status acmsdi_sign_in N2001 ACMS Desktop Gateway node HAL username HELLO_D...

Page 31: ...submitter_id returned by the acmsdi_sign_in service call_options Type ACMSDI_CALL_OPTION Access read Mechanism by reference An array of ACMSDI_CALL_OPTION elements that either enables unidirectional w...

Page 32: ...Access read Mechanism by reference Used by the desktop client program to pass additional information to the task Maximum length is 256 status_message Type char Access write Mechanism by reference A b...

Page 33: ...e defined in the ACMSDI H include file into which the acmsdi_call_ task service writes a newly created call identification a handle used by the TP Desktop Connector client services to identify an acti...

Page 34: ...rvice are listed in Table 2 2 Table 2 2 acmsdi_call_task Return Status Values Status Description ACMSDI_APPLDEAD Application stopped unexpectedly ACMSDI_CALLACTV Call is already active ACMSDI_INSUFPRM...

Page 35: ...I_SIGNINACTV Request is invalid while the sign in is active ACMSDI_SIGNOUTACTV Request is invalid while the sign out is active ACMSDI_SRVDEAD Node name is invalid or TP Desktop Connector gateway is no...

Page 36: ...DI_SUBMITTER_ID Access read Mechanism by reference The submitter_id for the session associated with the task that is being canceled call_id Type ACMSDI_CALL_ID Access read Mechanism by reference The c...

Page 37: ...lled when the service completes The completion_ routine is called by the ACMSDI_DISPATCH_MESSAGE service when the appropriate reply is received from the TP Desktop Connector gateway on the OpenVMS sys...

Page 38: ...or obsolete submitter identification ACMSDI_NOMEMORY Insufficient memory to complete requests ACMSDI_NORMAL Normal successful completion ACMSDI_PENDING Successful operation pending nonblocking complet...

Page 39: ...g Guide Format acmsdi_complete_pp call_id pp_status Parameters call_id Type ACMSDI_CALL_ID Access read Mechanism by reference The call_id parameter is passed back on the acmsdi_call_task service pp_st...

Page 40: ...fication ACMSDI_INVSUBID Invalid or obsolete submitter identification ACMSDI_NOMEMORY Insufficient memory to complete requests ACMSDI_NOPPACTV No presentation procedure active for this call ACMSDI_NOR...

Page 41: ...Desktop Connector message is received the service calls the appropriate completion routine or presentation procedure and then returns see Compaq TP Desktop Connector for ACMS Client Application Progr...

Page 42: ...n Status Values Status Description ACMSDI_NORMAL Normal successful completion ACMSDI_SRVDEAD Node name is invalid or TP Desktop Connector gateway is not running on the specified node or the network li...

Page 43: ...ns the address of a workspace argument to the contents of a pointer address argument This service may be used in the forced nonblocking environment to obtain reference pointers to structures such as c...

Page 44: ...Type char Access read Mechanism by reference The node name of the ACMS system where the user is to be signed in Maximum length is 80 username Type char Access read Mechanism by reference The name of...

Page 45: ...t the completion_ status parameter is set to zero when the service starts successfully When the service completes completion_status contains the final status See Table 2 6 for a list of return status...

Page 46: ...her blocking or nonblocking ACMSDI_NOACMS ACMS system not available ACMSDI_NOCOMPRESS Gateway does not allow compression ACMSDI_NOMEMORY Insufficient memory to complete requests ACMSDI_NORMAL Normal s...

Page 47: ...ice completion_status Type int Access write Mechanism by reference The final status of the service In the blocking environment the completion_ status parameter is set to zero when the service starts s...

Page 48: ...nvalid while task call is active ACMSDI_INSUFPRM Insufficient parameters ACMSDI_INTERNAL Internal TP Desktop Connector error ACMSDI_INVSUBID Invalid or obsolete submitter identification ACMSDI_MIXEDMO...

Page 49: ...atus Description ACMSDI_SIGNOUTACTV Request is invalid while sign out is active ACMSDI_SRVDEAD Node name is invalid or TP Desktop Connector gateway is not running on the specified node or the network...

Page 50: ......

Page 51: ...a nonblocking session These are not applicable to a forced nonblocking session For more information on presentation procedures refer to Compaq TP Desktop Connector for ACMS Client Application Programm...

Page 52: ...ncluding DECforms TDMS and application defined values Return status values for nonblocking presentation procedures are returned using the acmsdi_complete_pp routine The status value is passed to the A...

Page 53: ...Prototypes and Code for Presentation Procedures and Version Routines The ACMSDI H file contains function prototypes for the presentation procedures and action routines that your code supplies The file...

Page 54: ...c presentation procedure to handle interaction with the user The second part uses the acmsdi_complete_pp service to indicate that exchange step processing is completed The TP Desktop Connector client...

Page 55: ...sociates the session with the form specified in the acmsdi_enable request see Section 3 5 call_id Type ACMSDI_CALL_ID Access read Mechanism by reference The call identification used to complete the di...

Page 56: ...urned by the acmsdi_sign_in service see Section 2 11 forms_session Type ACMSDI_FORMS_SESSION_ID Access write Mechanism by reference An identification that associates the session with the submitter ide...

Page 57: ...Client Application Programming Guide for guidelines on specifying the form name forms_print_file Type char Access read Mechanism by reference The DECforms specification for the user in ACMSUDF DAT for...

Page 58: ...acmsdi_enable Return Status The status values returned by the acmsdi_enable procedure are described in Section 3 1 1 3 8 Portable API Presentation Procedures...

Page 59: ...e value returned by the acmsdi_sign_in service msg_text Type char Access write Mechanism by reference A buffer into which the presentation procedure will write the text from the form s Message Field t...

Page 60: ...anism by value Application specific context for the call This is the same context that was passed by the application to the acmsdi_call_task service which initiated the ACMS task associated with this...

Page 61: ...orms_session Type ACMSDI_FORMS_SESSION_ID Access read Mechanism by reference An identification to associate the session with the form specified in the acmsdi_ enable request see Section 3 5 receive_re...

Page 62: ...from the ACMS task send_control_text_count Type long int Access read Mechanism by value The number of send control text items sent from the ACMS task timeout Type short int Access read Mechanism by va...

Page 63: ...ce An array of ACMSDI_FORM_RECORD structures pointing to buffers that store application data and shadow records from the request see Section 3 1 2 Return Status The status values returned by the acmsd...

Page 64: ...kspace_count workspaces call_id call_context Parameters submitter_id Type ACMSDI_SUBMITTER_ID Access read Mechanism by reference The value returned by the acmsdi_sign_in service see Section 2 11 reque...

Page 65: ..._CALL_ID Access read Mechanism by reference The call identification returned by the acmsdi_call_task service call_context Type void Access read Mechanism by value Application specific context for the...

Page 66: ...ssion Type ACMSDI_FORMS_SESSION_ID Access read Mechanism by reference An identification that associates the session with the form specified in the acmsdi_enable request see Section 3 5 send_record_ide...

Page 67: ...rom the ACMS task send_control_text_count Type long int Access read Mechanism by value The number of send control text items sent from the ACMS task timeout Type short int Access read Mechanism by val...

Page 68: ...array of ACMSDI_FORM_RECORD structures pointing to buffers containing application data and shadow records sent from the ACMS task see Section 3 1 2 Return Status The status values returned by the acm...

Page 69: ...ext send_control_text_count timeout call_id call_context send_record receive_record Parameters forms_session Type ACMSDI_FORMS_SESSION_ID Access read Mechanism by reference An identification that asso...

Page 70: ...the form name receive_record_count Type long int Access read Mechanism by value The number of receive record items sent from the ACMS task receive_control_text Type char Access write Mechanism by ref...

Page 71: ...ism by value Application specific context for the call This is the same context that was passed by the application to the acmsdi_call_task call send_record Type ACMSDI_FORM_RECORD array Access read Me...

Page 72: ...acmsdi_transceive Return Status The status values returned by the acmsdi_transceive procedure are described in Section 3 1 1 3 22 Portable API Presentation Procedures...

Page 73: ...sk in the form s Message Field Format acmsdi_write_msg submitter_id msg_text call_id call_context Parameters submitter_id Type ACMSDI_SUBMITTER_ID Access read Mechanism by reference The value returned...

Page 74: ...hanism by value Application specific context for the call This is the same context that was passed by the application to the acmsdi_call_task service which initiated the ACMS task associated with this...

Page 75: ...tring 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 fo...

Page 76: ...he TP Desktop Connector run time system terminates the ENABLE request If the version checking routine determines that software is not synchronized it does one of the following Returns an OpenVMS failu...

Page 77: ...ws system version checking occurs during enable processing Format acmsdi_get_version form_file version Parameters form_file Type char Access read Mechanism by reference Form file or request library sp...

Page 78: ......

Page 79: ...nblocking Table 4 1 summarizes the forced nonblocking calls to the TP Desktop Connector API For more information on forced nonblocking calls refer to Compaq TP Desktop Connector for ACMS Client Applic...

Page 80: ...d exchange step acmsdi_bind_send_recs Services send and transceive exchange steps which send data from the TP Desktop Connector gateway to the desktop client acmsdi_bind_session_id Sends the forms ses...

Page 81: ...ECORD_BIND 4 1 2 ACMSDI_WORKSPACE_BIND Structure Defined in the ACMSDI H file the ACMSDI_WORKSPACE_BIND type declares workspaces passed to tasks using the acmsdi_call_task service and workspaces passe...

Page 82: ...orkspaces Parameters submitter_id Type ACMSDI_SUBMITTER_ID Access read Mechanism by reference The submitter_id returned by the acmsdi_sign_in service completion_status Type int Access write Mechanism...

Page 83: ...ient services write past the end of the allocated string and can cause the application to fail Ensure that the desktop client program allocates the required length of space workspaces Type ACMSDI_WORK...

Page 84: ...exchange step processing is active ACMSDI_INSUFPRM Insufficient parameters ACMSDI_INTERNAL Internal TP Desktop Connector error ACMSDI_INVCALLID Invalid or obsolete call identification ACMSDI_INVSUBID...

Page 85: ...ACMSDI_SUBMITTER_ID Access read Mechanism by reference The value returned by the acmsdi_sign_in service see Section 2 11 file_specification Type char Access write Mechanism by reference The form file...

Page 86: ...rence The DECforms specification for the user in ACMSUDF DAT forms_language Type char Access write Mechanism by reference The DECforms specification for the user in ACMSUDF DAT call_id Type ACMSDI_CAL...

Page 87: ...SUFPRM Insufficient parameters ACMSDI_INVSUBID Invalid or obsolete submitter identification ACMSDI_MIXEDMODE Not a forced nonblocking session ACMSDI_NORMAL Normal successful completion ACMSDI_WRONG_BI...

Page 88: ...is larger than the text being acquired the text is left justified in the buffer and right filled with blank characters This is an optional call that is you are not required to issue this call However...

Page 89: ...fer 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...

Page 90: ...fficient parameters ACMSDI_INVSUBID Invalid or obsolete submitter identification ACMSDI_MIXEDMODE Not a forced nonblocking session call ACMSDI_NORMAL Normal successful completion ACMSDI_WRONG_BIND Try...

Page 91: ...at acmsdi_bind_receive_args submitter_id forms_session receive_record_identifier receive_record_count timeout call_id Parameters submitter_id Type ACMSDI_SUBMITTER_ID Access read Mechanism by referenc...

Page 92: ...ll identification returned by the acmsdi_call_task service To identify the original task call compare this pointer with a reference pointer to the call identifier obtained by acmsdi_return_pointer Ret...

Page 93: ...lue returned by the acmsdi_sign_in service see Section 2 11 receive_control_text_flag Type short integer Access read Mechanism by value A value of 1 indicates that receive control text is to be sent t...

Page 94: ..._recs Return Status Values Status Description ACMSDI_INSUFPRM Insufficient parameters ACMSDI_INVSUBID Invalid or obsolete submitter identification ACMSDI_MIXEDMODE Not a forced nonblocking session ACM...

Page 95: ...received from and then sent back to ACMS This is an optional call Format acmsdi_bind_request_args submitter_id request_name workspace_count call_id Parameters submitter_id Type ACMSDI_SUBMITTER_ID Acc...

Page 96: ...rn Status The status values returned by the acmsdi_bind_request_args service are described in Table 4 7 Table 4 7 acmsdi_bind_request_args Return Status Values Status Description ACMSDI_INSUFPRM Insuf...

Page 97: ...ubmitter_id direction req_wksp_array Parameters submitter_id Type ACMSDI_SUBMITTER_ID Access read Mechanism by reference The value returned by the acmsdi_sign_in service see Section 2 11 direction Typ...

Page 98: ..._wksps Return Status Values Status Description ACMSDI_INSUFPRM Insufficient parameters ACMSDI_INVSUBID Invalid or obsolete submitter identification ACMSDI_MIXEDMODE Not a forced nonblocking session AC...

Page 99: ...sdi_bind_send_args submitter_id forms_session send_record_identifier send_record_count timeout call_id Parameters submitter_id Type ACMSDI_SUBMITTER_ID Access read Mechanism by reference The submitter...

Page 100: ...identification returned by the acmsdi_call_task service To identify the original task call compare this pointer with a reference pointer to the call identifier obtained by acmsdi_return_pointer Retur...

Page 101: ...returned by the acmsdi_sign_in service see Section 2 11 send_control_text_flag Type short integer Access read Mechanism by value A value of 1 indicates that send control text is to be copied from the...

Page 102: ...s Return Status Values Status Description ACMSDI_INSUFPRM Insufficient parameters ACMSDI_INVSUBID Invalid or obsolete submitter identification ACMSDI_MIXEDMODE Not a forced nonblocking session ACMSDI_...

Page 103: ...by reference The value returned by the acmsdi_sign_in service see Section 2 11 forms_session Type ACMSDI_FORMS_SESSION_ID Access read Mechanism by reference An identification that associates the sess...

Page 104: ...n_id Return Status Values Status Description ACMSDI_INSUFPRM Insufficient parameters ACMSDI_INVSUBID Invalid or obsolete submitter identification ACMSDI_MIXEDMODE Not a forced nonblocking session ACMS...

Page 105: ...calls for receive forms records and receive control text See Section 4 10 for information on calls for send forms records and send control text This is an optional call Format acmsdi_bind_transceive_...

Page 106: ...the ACMS task Refer to Compaq TP Desktop Connector for ACMS Client Application Programming Guide for guidelines on specifying the form name receive_record_count Type long int Access write Mechanism b...

Page 107: ...ceive_args Return Status Values Status Description ACMSDI_INSUFPRM Insufficient parameters ACMSDI_INVSUBID Invalid or obsolete submitter identification ACMSDI_MIXEDMODE Not a forced nonblocking sessio...

Page 108: ...st in the client application s memory The client application can compare this pointer with that returned by the acmsdi_return_pointer service to identify the completed call The call context is identif...

Page 109: ...Values Status Description ACMSDI_CANCEL_DONE Task cancel call complete ACMSDI_DONE Sign in sign out or task call complete ACMSDI_ENABLE_EXCH Enable exchange step has arrived ACMSDI_EXCHACTV Request i...

Page 110: ...sktop Connector gateway is not running on the server node or the network link has been terminated ACMSDI_TDMS_READ_EXCH TDMS Read exchange has arrived ACMSDI_TDMS_WRITE_EXCH TDMS Write exchange has ar...

Page 111: ...stem management service available on systems running the TP Desktop Connector gateway The ACMSDI GET_ SUBMITTER_INFO service returns information about the status of TP Desktop Connector gateway proces...

Page 112: ...hat uses the ACMSDI GET_SUBMITTER_INFO service the source file C and the build command procedure COM See Compaq TP Desktop Connector for ACMS Client Application Programming Guide for more information...

Page 113: ...o Figure 5 1 shows the item descriptor format Figure 5 1 Submitter Item Descriptor Format MR 5219 AD 31 16 15 0 Item Code Buffer Length Buffer Address Return Length Address The valid item codes are de...

Page 114: ...ME Action Returns the name of the network node from which the desktop submitter is signed in to the ACMS system Description The buffer address field in the item descriptor points to a user provided bu...

Page 115: ...nder which the desktop submitter is signed in Description The buffer address field in the item descriptor points to a user provided buffer into which the ACMSDI GET_ SUBMITTER_INFO service writes the...

Page 116: ...itter matches the selection criteria ACMSDI _NOMORESUBS No more submitters to report No information was reported by this call because no more submitters match the selection criteria The snapshot is co...

Page 117: ...se to monitor compression activity You can shorten all commands and keywords to the smallest unambiguous abbreviation which is at most three characters See Compaq TP Desktop Connector for ACMS Client...

Page 118: ...EXIT 6 1 EXIT This command exits the Compression Monitor Activity reporting program Format EXIT 6 2 Data Compression Monitor Commands...

Page 119: ...HELP 6 2 HELP Displays the help file SYS HLP ACMSDI DCM_REPORTER_HLP TXT Format HELP Data Compression Monitor Commands 6 3...

Page 120: ...LICATION on the LIST command selects records for all applications overriding any defaults that are set BEFORE date time Selects detailed records that were written before the date and time specified Th...

Page 121: ...iding any defaults that may be set SINCE date time Selects detailed records that were written on or after the date and time specified The date time specification is optional If you omit it the records...

Page 122: ...ed unless default user identifier s have been selected with the SET command Specifying USER on the LIST command overrides any default user identifiers that may have been set Specifying USER on the LIS...

Page 123: ...n today after midnight yesterday or 0 00 today 13 SINCE 13 JUN Selects records written after midnight June 12th of the current year 14 SINCE 11 25 Selects records written at or after 11 25 this mornin...

Page 124: ...MAIN PLANT 20 USER SCHMIDT MASELLA RAJIV SWEENEY Selects all records for sessions established for user identifiers SCHMIDT MASELLA RAJIV and SWEENEY 21 USER SITE3 Selects all records for sessions esta...

Page 125: ...RENEW 6 4 RENEW This command closes the current log file and opens a new one The new log file is a new version of ACMSDI COMPRESSION LOG Format RENEW Data Compression Monitor Commands 6 9...

Page 126: ...ecifications If you do not specify APPLICATION records for all applications are selected unless you set default application s with the SET command Specifying APPLICATION with the SELECT command overri...

Page 127: ...dd mmm yyyy hh mm ss TASK task name Selects detailed records associated with ACMS task calls for the task name s specified including any exchange steps associated with the task calls The task name sp...

Page 128: ...ER with the SELECT command overrides any default user identifiers that may have been set Specifying USER with the SELECT command specifies that records for all user sessions are selected overriding an...

Page 129: ...f you do not specify APPLICATION records for all applications are selected DETAILS This default is applicable to the LIST command only It specifies that the report is to contain detailed information f...

Page 130: ...ted with the task calls The task name specification can be a valid ACMS task name or a list of task names If you specify a list separate the names with a comma and enclose the list within parentheses...

Page 131: ...r DETAILS Displays DETAILS if DETAILS is the default displays SUMMARY if SUMMARY is the default DETAILS and SUMMARY are mutually exclusive INPUT Displays the default for the INPUT qualifier NODE Displ...

Page 132: ......

Page 133: ...arameters ACMSDI_INTERNAL 3004 Internal error ACMSDI_INVCALLID 3005 Invalid call identification ACMSDI_INVLOGIN 3006 Invalid login attempt ACMSDI_INVOPTION 3007 Invalid submitter option ACMSDI_INVSUBI...

Page 134: ...o complete normally ACMSDI_INVPROTOCOL 3025 Protocol versions of the DDEV and the TP Desktop Connector server do not match ACMSDI_BADNODENAME 3026 Invalid node name ACMSDI_PWDEXPIRED 3027 Password has...

Page 135: ...Descriptions of client messages and server messages are provided in the following files SYS HELP ACMSDI CLIENT_MESSAGES TXT SYS HELP ACMSDI SERVER_MESSAGES TXT Compaq ACMS System Status Values A 3...

Page 136: ......

Page 137: ..._bind_transceive_args routine description of interface 4 27 ACMSDI_CALL_ID data type 1 2 ACMSDI_CALL_OPTIONS data type structure 1 2 acmsdi_call_task service description 2 13 acmsdi_cancel service des...

Page 138: ...er service description 2 25 acmsdi_send routine description of interface 3 16 acmsdi_sign_in service description 2 26 acmsdi_sign_out service description 2 29 ACMSDI_SUBMITTER_ID data type structure 1...

Page 139: ...onblocking presentation procedure usage 3 4 restriction 2 3 3 4 specifying 2 2 O OpenVMS system management service 5 1 Options specifying sign in 2 27 P Parameter allocating memory 3 3 data type 1 2 p...

Page 140: ...gateway 5 4 program for information 5 2 Submitter_id description 2 27 System status values A 1 T Target desktop ID 5 5 Target submitter ID 5 5 Task cancellation status 2 15 4 4 TCP IP port number 2 1...

Reviews: