| Previous | Contents | Index |
Directs the report to a file named DAILY_COMPRESSION.REP in the current directory.
| #12 |
|---|
/SINCE |
Selects records written 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 morning.
| #15 |
|---|
/SINCE=12-OCT-1998:8:0:45 |
Selects records written at or after 45 seconds after 8 a.m. on October 12, 1998.
| #16 |
|---|
/TASK=HYACINTH |
Selects records for task calls for ACMS task HYACINTH.
| #17 |
|---|
/TASK=(APRIL,MAY,JUNE) |
Selects records for task calls for ACMS tasks APRIL, MAY, and JUNE.
| #18 |
|---|
/TASK=*DEF |
Selects all records for task calls associated with tasks with names ending in DEF.
| #19 |
|---|
/USER=MAIN-PLANT |
Selects all records for sessions established for user identifier 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 established for user identifiers that begin with SITE3.
8.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.
RENEW
8.5 SELECT
This command selects records from the log file and writes them to a
file from which you can generate customized reports. If you do not
specify a qualifier, all records are selected.
SELECT file [/qualifier]
file
Is a required parameter that specifies the name of the file to which the selected records are written.
/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 unless you set default application(s) with the SET command.Specifying /APPLICATION with the SELECT command overrides any default applications that you previously set. Specifying /APPLICATION=* on the SELECT 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. The date-time specification is optional. If you omit it, records written earlier than the current date are selected. Specify date and time in the OpenVMS standard format dd-mmm-yyyy:hh-mm-ss./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. If you do not specify /NODE, records for all nodes are selected unless you set default node(s) with the SET command.Specifying /NODE with the SELECT commands overrides any default nodes that you may have set. Specifying /NODE=* with the SELECT commands specifies that records for all nodes are to be selected, overriding any defaults that you may have 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 written on the current date are selected. Specify the date and time in the OpenVMS format, 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 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 do not specify the /TASK qualifier, records for all tasks are selected, unless you have specified another default with the SET command. If you specify /TASK=* with the SELECT command, 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. If /USER is not specified, records for all users are selected, unless default user identifier(s) have been selected with the SET command. Specifying /USER 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 any defaults that may have been set.
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.
SET /qualifier
/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.
SHOW [/qualifier]
/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.
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.
| 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 | ACMS Desktop 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 ACMS Desktop 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 |