Writes values from the ACMSGEN work area to a work file, creating a new version of the file.

Format

WRITE file-spec

Privileges Required

None

Parameters

file-spec

The file specification of the work file where you want ACMSGEN to write the parameter work area. The file specification cannot be an existing version of a file. SYS$SYSTEM is the default device and directory. The default file type is .ACM. There is no default file name.

Notes

Use the SHOW command to check that the work area contains the appropriate values before using the WRITE command.

Examples

ACMSGEN> WRITE WORK
      

This command writes values from the ACMSGEN work area to the work file SYS$SYSTEM:WORK.ACM, creating a new version of the file.

ACMSGEN> USE ACTIVE
ACMSGEN> WRITE WORK
      

These commands copy active values for dynamic parameters to a work file. The USE ACTIVE command initializes the work area with active values for all parameters. The WRITE command writes values from the work area to the WORK.ACM work file, creating a new version of the file.

Changes active values for dynamic parameters by writing values from the ACMSGEN work area to an ACMS system global section.

Format

WRITE ACTIVE

Privileges Required

OpenVMS OPER privilege

Notes

The WRITE ACTIVE command updates active values for any of the following parameters:

• MAX_LOGINS
• MAX_TTS_CP
• MIN_CPIS
• MSS_NET_RETRY_TIMER
• PERM_CPS
• QTI_POLLING_TIMER
• QTI_SUB_TIMEOUT
• QTI_RETRY_TIMER
• USERNAME_DEFAULT

For other parameters, you can change current values only.

Use the SHOW command to check that the work area contains the appropriate values before using the WRITE ACTIVE command. New active values last until the system stops or until you change them again. If the system is inactive when you use the WRITE ACTIVE command, you receive an error message, and no changes are made.

Examples

ACMSGEN> USE ACTIVE
ACMSGEN> SET PERM_CPS 2
ACMSGEN> WRITE ACTIVE
      

These commands change the active values for PERM_CPS to 2. The USE ACTIVE command initializes the work area with active values for all parameters. The SET command places 2 in the work area as the value for PERM_CPS. The WRITE ACTIVE command writes the values for dynamic parameters from the work area to the system global section containing values for the active system.

ACMSGEN> USE DEFAULT
ACMSGEN> WRITE ACTIVE
      

These commands reset the active values for dynamic parameters to ACMS default values. The USE DEFAULT command initializes the work area with default values for all parameters. The WRITE ACTIVE command updates active values for dynamic parameters with values from the ACMSGEN work area.

Changes current values by writing values from the ACMSGEN work area to the SYS$SYSTEM:ACMSPAR.ACM file.

Format

WRITE CURRENT

Privileges Required

Write access to the SYS$SYSTEM directory. The OpenVMS privilege SYSPRV or a system UIC gives you write access to SYS$SYSTEM.

Notes

Use the SHOW command to check that the work area contains the appropriate values before using the WRITE CURRENT command.

When you use an ACMS START /SYSTEM command, ACMS initializes the global section for active values with values from the ACMSPAR.ACM file.

Examples

ACMSGEN> SET PERM_CPS 3
ACMSGEN> WRITE CURRENT
      

These commands change the current value of PERM_CPS to 3. By default, the work area contains current values. The SET command changes the value for PERM_CPS in the work area to 3. The WRITE CURRENT command writes values from the work area to the SYS$SYSTEM:ACMSPAR.ACM file as new current values for ACMS.

ACMSGEN> USE DEFAULT
ACMSGEN> WRITE CURRENT
      

These commands reset the current values of ACMS to defaults. The USE DEFAULT command initializes the work area with default values. The WRITE CURRENT command copies values from the work area to the SYS$SYSTEM:ACMSPAR.ACM file as new current values for ACMS.

This chapter contains reference information and examples for the ACMS Audit Trail Report (ATR) Utility commands. See Chapter 12 for general information about the ATR Utility.

Ends the ATR Utility session and returns you to the DCL prompt.

Format

EXIT

Privileges Required

None

Notes

You can also end an ATR session with a controlled exit by pressing [Ctrl/Z]. [Ctrl/Z] signals the end of the file for data entered from the terminal. [Ctrl/Z] is displayed as EXIT.

Example

ATR> EXIT
      

This command ends an ATR Utility session and returns you to the DCL prompt.

Displays information about ATR Utility commands and their qualifiers.

Format

HELP [ topic [...]]

Privileges Required

None

Parameters

topic

The ATR topic you want to know about. If you do not specify a topic, ACMS displays a list of topics for you to choose from.

Notes

None

Example

ATR> HELP ERRORS 
    Audit/Trace Message Formats
   Additional information available:
   BYNAME  ENDTOOSOON   IDLOGGONE   INVID    NOTYPE    REC_CORRUPT
ERRORS Subtopic?
      

This command displays help information about the audit trail error messages.

Produces a report about information in the audit trail log file. You can limit the amount of information in the report by using qualifiers.

Format

LIST [ file-spec ]

Command Qualifiers	Defaults
/APPLICATION=application-name	All application names
/BEFORE[=time]	Full report
/BRIEF	Full report
/IDENTIFICATION=task-id	All task IDs
/OUTPUT=file-spec	SYS$OUTPUT
/SINCE[=time]	Full report
/SUBMITTER=submitter-id	All submitter IDs
/TASK=task-name	All task names
/TERMINAL=device-name	All device names
/TYPE=type	All types
/USERNAME=user-name	All user names

Privileges Required

OpenVMS SYSPRV

Parameters

file-spec

The file specification of the audit trail log file that is used to generate the report. The file specification can be any version of the audit trail log or a concatenated file containing several audit trail log files. If you do not supply a file specification, the file defined as ACMS$AUDIT_LOG is used. If the ACMS$AUDIT_LOG logical is undefined and you omit the file specification, the default file specification SYS$ERRORLOG:ACMSAUDIT.LOG is used. If you supply only a partial file specification, missing parts are taken from SYS$ERRORLOG:ACMSAUDIT.LOG.

Qualifiers

/APPLICATION=application-name

Limits the report to records involving the application you name. Application-name is the file name of an application database.

/BEFORE[=time]

Limits the report to records logged before the time you specify. Specify time as an OpenVMS absolute time. If you specify the /BEFORE qualifier without a time argument, the default is /BEFORE=TODAY. If you do not specify the /BEFORE qualifier, a full report is displayed. You can use the /SINCE qualifier with the /BEFORE qualifier.

/BRIEF

Limits the length of records in the report. Each record in a brief report contains the time of the entry in the audit trail log and the type of information in the entry. For a description of record types, see the description of the /TYPE qualifier. If you do not use the /BRIEF qualifier, you get a full report.

/IDENTIFICATION=task-id

Limits the report to records generated by the specified task ID. The task ID is the unique identification code ACMS assigns to an active task. See Section 12.6.1 for a description of the task ID format and how to specify a task ID.

/OUTPUT=file-spec

Writes an ACMS Log Report to the output file you name. Output goes to SYS$OUTPUT by default.

/SINCE[=time]

Limits the report to records logged after the time you specify. Specify the time as an OpenVMS absolute time. If you specify the /SINCE qualifier without the time argument, the default is /SINCE=TODAY. If you do not specify the /SINCE qualifier, the default is a full report. You can use the /SINCE qualifier with the /BEFORE qualifier.

/SUBMITTER=submitter-id

Limits the report to records generated by the specified submitter ID. The submitter ID is the unique task submitter code ACMS assigns to an ACMS user at sign-in. The submitter ID begins with the name of the node on which the user signed in. You can omit leading zeros in the submitter ID. See Section 12.6.1 in Chapter 12 for a description of the submitter ID format and of how to specify a submitter ID.

/TASK=task-name

Limits the report to records that match the task name you specify. The task name is the name defined in the application definition.

/TERMINAL=device-name

Limits the report to records of sign-ins and sign-outs from the specified terminal. Device-name is the name of a terminal that runs ACMS tasks. You must end the device name with a colon (:).

/TYPE=type

Limits the report to records of one type. The possible types of reports are:

• ALL---generates a report on all records. ALL is the default.
• COMMAND---generates a report on ACMS operator commands.
• ERROR---generates a report on errors.
• LOGIN---generates a report on all sign-ins and sign-outs.
• OTHER---generates a report that tells you when the Audit Trail Logger is enabled or disabled, opened or closed, and logs each use of the ACMS/RESET AUDIT command.
• TASK---generates a report on task information, excluding errors.

/USERNAME=user-name

Limits the report to records generated by the specified user name.

Notes

If you use the LIST command without qualifiers, the ATR report includes all records in the input file.

Press the PF1 and PF2 keypad keys for access to a keypad of ATR commands. Press [Ctrl/B] to recall each ATR command you enter.

When you use ATR to read information from the latest version of the audit trail log while the Audit Trail Logger is active, audit trail information may be a few seconds behind ACMS activity. Records are forced out to the audit trail log file based on both the number of records that have been written since the last forced write, and the time elapsed since the last request was responded to.

Examples

ATR> LIST/SINCE=09-MAR-1994 9:00/BEFORE=09-MAR-1994 10:00
      

This command displays all records written between 9 and 10 a.m. on March 9, 1994.

ATR> LIST/APPLICATION=TEST/OUTPUT=AUDITRPT.LIS
      

This command writes records for the application TEST to the output file AUDITRPT.LIS.

ATR> LIST/BRIEF
      

This command displays partial records, including the time of each entry and the type of information recorded.

ATR> LIST/IDENTIFIER=-1
      

This command lets you see the first task selection for each submitter. You specify only the sequence number on the /IDENTIFIER qualifier. Because you omit the local ID field, you indicate that you are omitting that field by using a dash.

ATR> LIST/TASK=UPDATE/OUTPUT=AUDITRPT.LIS
      

This command writes records for the Update task to the listing file AUDITRPT.LIS.

ATR> LIST/TERMINAL=TTA5:
      

This command displays all sign-ins and sign-outs from terminal TTA5.

ATR> LIST/TYPE=COMMAND
      

This command displays all instances of operator command usage.

ATR> LIST/TYPE=ERROR
      

This command displays records of errors.

ATR> LIST/TYPE=LOGIN
      

This command displays sign-ins and sign-outs for all users on an ACMS system.

ATR> LIST/TYPE=TASK
      

This command displays all records involving tasks.

ATR> LIST/TYPE=OTHER
      

This command displays records of when the audit trail log is opened and closed, when the Audit Trail Logger is enabled and disabled, and when the audit trail log is renewed with the ACMS/RESET AUDIT command.

ATR> LIST/USERNAME=CONNOR
      

This command displays records for a user or users signed in under the user name CONNOR.