Compaq TP Desktop Connector
for ACMS
Client Services Reference Manual


Previous Contents Index

8.6 SET

This command sets default values for the LIST and SELECT commands. All qualifiers, except /BEFORE and /SINCE, can have a default value. You can use the SHOW command to display the current default settings. When you set a default, it applies to all reports you request with the LIST command and to all records you select with the SELECT command. However, you can override these default settings on the command line by specifying certain qualifiers.

Format

SET /qualifier


Qualifiers

/APPLICATION=application

Allows you to select detailed records associated with the application(s) specified. The application specification can be an ACMS application name or a list of application names. If you specify a list, separate the names with a comma and enclose the list within parentheses. The asterisk (*) wild card character is permitted in application name specifications. If 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 for all calls. This is the standard default.

/INPUT=file

Specifies a source file from which records for the report are to be read. If you do not specify a source file, the latest version of SYS$ERRORLOG:ACMSDI$COMPRESSION.LOG is used, unless you have previously specified a default input file using the SET command. To override a default input file setting, use /INPUT=* on the LIST command.

/NODE=(node-identifier[,...])

Selects detailed records associated with task calls originating from the client node(s) specified. The node-identifier can be a DECnet node name, TCP/IP address, or a list of same. If you specify a list, separate the identifiers with commas and enclose the list within parentheses. If you specify a single identifier, you do not need the comma and parentheses. The asterisk (*) wild card character is permitted in node identifiers.

/OUTPUT=file

Directs the report to a file. The file specification must be a valid OpenVMS file specification. Displaying the report on the screen is the default, unless you specify the /OUTPUT qualifier with the SET command. Specifying /OUTPUT=* with the LIST command, displays any reports on the screen, overriding any defaults that may be set.

/SUMMARY

Specifies that a summary report, omitting details, be written. The default is a detailed report containing all calls be written. You can set your own default with the SET command. Summary reports show totals of the uncompressed workspace sizes, the compressed workspace sizes, and the number of bytes saved by data compression.

/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 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. You can use the asterisk (*) wild-card character in the task-name specification. If you specify /TASK=*, records for all tasks are selected. If tasks specified are part of more than one ACMS application, matching task details for all applications are selected, unless you narrow the selection further with the /APPLICATION qualifier.

/USER=user-identifier

Selects detailed records associated with ACMS task calls executed for the signed-in user session(s) specified. The user-identifier specification can be a user identifier or a list of user identifiers. If you specify a list, separate the identifiers with a comma and enclose the list within parentheses. The asterisk (*) wild card character is permitted in user identifier specifications. Specifying /USER=*, selects records for all users.

8.7 SHOW

This command displays the default values for qualifiers of the LIST and SELECT commands, which you have set with the SET command. All command qualifiers, except /BEFORE and /SINCE, can have a default value. Specifying SHOW without any qualifiers displays all defaults.

Format

SHOW [/qualifier]


Qualifiers

/APPLICATION

Displays the default for /APPLICATION qualifier.

/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

Displays the default for the /NODE qualifier.

/OUTPUT

Displays the default for the /OUTPUT qualifier.

/SUMMARY

Displays /SUMMARY if /SUMMARY is the default; displays /DETAILS if /DETAILS is the default. /SUMMARY and /DETAILS are mutually exclusive.

/TASK

Displays the default for the /TASK qualifier.

/USER

Displays the default for the /USER qualifier.


Appendix A
Compaq ACMS System Status Values

Table A-1 lists the ACMS system status values and their corresponding numeric values as defined in ACMSDI.H and ACMSDI_MAC.H, returned in the err2 parameter, with corresponding symbols. For Macintosh client programs, these values are returned in the item2 parameter.

Table A-1 ACMS System Status Values
Symbol Value Text
ACMSDI_NORMAL 0 Normal completion
ACMSDI_APPLDEAD --3001 ACMS application not started
ACMSDI_CALLACTV --3002 Call active --- cannot start new operation
ACMSDI_INSUFPRM --3003 Insufficient parameters
ACMSDI_INTERNAL --3004 Internal error
ACMSDI_INVCALLID --3005 Invalid call identification
ACMSDI_INVLOGIN --3006 Invalid login attempt
ACMSDI_INVOPTION --3007 Invalid submitter option
ACMSDI_INVSUBID --3008 Invalid submitter identification
ACMSDI_MIXEDMODE --3009 Using both blocking & non-blocking modes
ACMSDI_NOACMS --3010 ACMS not active
ACMSDI_NOMEMORY --3011 Low memory resource
ACMSDI_NOPPACTV --3012 No active presentation procedure
ACMSDI_NOSUCH_APPL --3013 ACMS application not found
ACMSDI_NOSUCH_TASK --3014 Invalid task code
ACMSDI_OPR_CANCELLED --3015 Operator canceled ACMS user
ACMSDI_PENDING --3016 Operation started
ACMSDI_SECCHK --3017 ACMS task ACL failure
ACMSDI_SIGNINACTV --3018 Sign-in in process
ACMSDI_SIGNOUTACTV --3019 Sign-out in process
ACMSDI_SRVDEAD --3020 TP Desktop Connector server has died
ACMSDI_TASK_ABORT --3021 Task has aborted
ACMSDI_TASK_CANCELLED --3022 Task canceled by operator
ACMSDI_TASK_SP_DIED --3023 Task procedure server process has died
ACMSDI_TASK_FAILED --3024 Task failed to 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 expired
ACMSDI_CANCELACTV --3028 Client-initiated cancel in progress
ACMSD_EXCHACTV --3029 User-written presentation procedure not completed
ACMSDI_DISPATCHACTV --3030 ACMSDI_DISPATCH_MESSAGE call in process
ACMSDI_UNSUPPORTED --3031 Unsupported option requested on acmsdi_sign_in or acmsdi_call_task
ACMSDI_PWDEXPIRING --3100 Number of hours returned until password expires
ACMSDI_CALL_CANCELED --3101 The task was canceled by the task submitter

Descriptions of client messages and server messages are provided in the following files:


Index Contents