Compaq TP Desktop Connector
for ACMS
Client Services Reference Manual
Previous Contents Index

Chapter 7
Serial-DECnet Gateway Management Commands

This chapter describes the Serial-DECnet gateway commands that you can use to manage TP Desktop Connector. For information on using serial communications with TP Desktop Connector, refer to Compaq TP Desktop Connector for ACMS Client Application Programming Guide.

7.1 TP Desktop Connector Serial-DECnet Gateway Management Commands

TP Desktop Connector provides the SYS$SYSTEM:ACMSDI$SERIAL_GATE_MANAGER.EXE utility, so that you can do the following:

To invoke this utility, specify the RUN command as in the following example: 


$ RUN SYS$SYSTEM:ACMSDI$SERIAL_GATE_MANAGER
ACMSDIGW$MANAGER> ATTACH TT:/NOPERMANENT
$ LOGOUT

The following sections describe the management commands for the TP Desktop Connector Serial-DECnet gateway.

7.2 ATTACH

This command attaches a terminal to the TP Desktop Connector serial gateway.

Format

ATTACH device

Parameters

device

Specifies the device that is to be attached to the TP Desktop Connector serial gateway. You can use TT: to specify the device that is currently in use.

Qualifiers

/BAUD=baud_rate

Specifies a baud rate. If the baud rate is not specified, or the baud rate is specified as zero, it remains unchanged.

/PERMANENT (D)

/NOPERMANENT

Indicates that the device is to be permanently attached to the TP Desktop Connector serial gateway. The device is detached only on a fatal error or with the DETACH command.

/SUSPEND

/NOSUSPEND (D)

Suspends the current process while the device is in TP Desktop Connector serial gateway mode. This qualifier is typically used to switch the current user's device from interactive mode to TP Desktop Connector serial gateway mode with the intent to return to interactive mode. Do not use this qualifier with the /PERMANENT qualifier.

/TIMEOUT=delta_time

Indicates a timeout for a client to start a session through the attached device. If a client does not start a session within the timeout period, the device is detached. This parameter is typically used when changing the current user's device from interactive mode to TP Desktop Connector serial gateway mode with the intent of returning to interactive mode. Do not use this qualifier with the /PERMANENT qualifier.

Examples

#1 

ACMSDIGW$MANAGER> ATTACH TTA3:/BAUD=9600

The device TTA3: is permanently (or until detached with a DETACH command) attached to the serial gateway. The device waits for connections from TP Desktop Connector clients. The baud rate is set to 9600. If this device is detached, the baud rate (and all other terminal characteristics) are reset to the original settings.

#2 

ACMSDIGW$MANAGER> ATTACH TT:/NOPERMANENT/SUSPEND/TIMEOUT=00:00:40

Switches the current connection from an interactive process to serial gateway mode. The current process is suspended. If an ACMSDI login is not made within 40 seconds, the serial gateway detaches the device and the interactive process is resumed. After all active sessions on the line are terminated, the device is detached and the interactive session is resumed.

#3 

!In a command file 
$ RUN SYS$SYSTEM:ACMSDI$SERIAL_GATEWAY_MANAGER ATTACH /DEVICE=TT:/NOPERM 
$ LOGOUT

If this command file is invoked, the device used by the current interactive process is switched to serial gateway mode and the current process is terminated. The device is detached if either a timeout condition (default is 60 seconds) occurs or when all active sessions on the line are terminated.

7.3 DETACH

This command detaches a terminal from the TP Desktop Connector serial gateway.

Format

DETACH device

Parameters

device

Specifies the device that is to be detached from the TP Desktop Connector serial gateway.

7.4 LIST

This command lists the devices currently attached to the TP Desktop Connector serial gateway.

Format

LIST

7.5 SHUTDOWN

This command detaches all the devices attached to the TP Desktop Connector serial gateway and shuts the gateway down. To specify this command you must have the SYSPRIV or BYPASS privileges.

Format

SHUTDOWN

7.6 START LOGGING

This command starts gateway logging. Certain TP Desktop Connector serial gateway events are placed in the log. Avoid logging while the gateway is in production. The default log file is:

Format

START LOGGING /qualifier

Qualifiers

/FILE=log_file_name

Specifies a TP Desktop Connector serial gateway log file. Specify a full path name. If a full path name is not provided, the log file is placed relative to the default of the TP Desktop Connector gateway.

7.7 STOP LOGGING

This command stops gateway logging.

Format

STOP LOGGING

Chapter 8
Data Compression Monitor Commands

This chapter provides a description of the Data Compression Monitor commands that you can use 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 Application Programming Guide for more information on using the Data Compression Monitor.

8.1 EXIT

This command exits the Compression Monitor Activity reporting program.

Format

EXIT

8.2 HELP

Displays the help file, SYS$HLP:ACMSDI$DCM_REPORTER_HLP.TXT.

Format

HELP

8.3 LIST

This command generates a report, which you can display on the screen or write to a file.

Format

LIST [/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 unless you set default application(s) with the SET command.

Specifying /APPLICATION with the LIST command overrides any default applications that you previously set. Specifying /APPLICATION=* 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. 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.

/DETAILS

Specifies that the report should contain details of all calls. This is the default, unless you specify /SUMMARY in the SET command. Specifying /DETAILS with the LIST command overrides SET/SUMMARY.

/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 LIST command overrides any default nodes that you may have set. Specifying /NODE=* with the LIST command specifies that records for all nodes are to be selected, overriding any defaults that you may have set.

/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.

/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.

/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 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 LIST 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 on the LIST command overrides any default user identifiers that may have been set. Specifying /USER=* on the LIST command specifies that records for all user sessions are selected, overriding any defaults that may have been set.

Examples

#1 

/APPLICATION=LARRY

Selects records for application LARRY.

#2 

/APPLICATION=(KURT,SARAH)

Selects records for applications KURT and SARAH.

#3 

/APPLICATION=*DEC*

Selects records for applications that contain DEC in their names.

#4 

/BEFORE

Selects records written yesterday and earlier.

#5 

/BEFORE=12-JUN

Selects records written prior to June 12th of this year.

#6 

/BEFORE=16:30

Selects records written prior to today at 4:30 p.m.

#7 

/BEFORE=12-JUN-1998:9:15:30

Selects records written prior to 30 seconds after 9:15 a.m. on June 12, 1998.

#8 

/NODE=ALPHA1

Selects all records for task calls from node ALPHA1.

#9 

/NODE=(LION,TIGER,PANTHR)

Selects all records for task calls from nodes LION, TIGER, and PANTHR.

#10 

/NODE=*CPQ*

Selects all records for task calls from nodes that contain CPQ in their names.

#11 

/OUTPUT=DAILY_COMPRESSION.REP

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.

Format

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.

Format

SELECT file [/qualifier]

Parameters

file

Is a required parameter that specifies the name of the file to which the selected records are written.

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 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.

Previous Next Contents Index