HPlogo MPE/iX Commands Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 2 Command Definitions A-B

ALTLOG

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

Alters the attributes of an existing user logging identifier.

Syntax

ALTLOG logid [ ;LOG=logfile { ,DISC ,TAPE } ] [ ;PASS=password[ { ;AUTO ;NOAUTO } ]

Parameters

logid

The logging identifier whose attributes are to be changed. This identifier must contain from one to eight alphanumeric characters, beginning with an alphabetic character.

logfile

The name of the file to receive data from the logging procedure. This name must contain from one to eight alphanumeric characters, beginning with an alphabetic character. You must specify the device class on which log file resides, either DISC or TAPE.

password

The new password for the logging identifier. This password must contain from one to eight alphanumeric characters, beginning with an alphabetic character.

AUTO

Initiates an automatic CHANGELOG if the current log file becomes full. This option is ignored is TAPE is specified. Refer to the CHANGELOG command.

NOAUTO

Prevents the initiation of an automatic CHANGELOG. A CHANGELOG is not performed if the current log file becomes full. Default.

Operation Notes

This command changes the attributes of an existing user logging identifier to those specified in the parameter list. Parameters not included in the ALTLOG command retain their current values. System supervisor (OP) or user logging (LG) capability is required to use this command. Only the creator of the logging identifier can alter its attributes.

To use the AUTO parameter, the log process for logid must be enabled for changing. You may do this by ending the log file name with the numeric characters 001 (for example, fname001). This naming convention works in conjunction with the file set number to generate sequential file names automatically.

If a log file is restricted to a single volume or volume class when it is created with the BUILD command, then successive log files created by User Logging will have the same restriction.

If a new log file name is specified with the ALTLOG command, the links with any previous log file are broken.

Use

This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command. User logging (LG) capability is required to use this command.

Example

To change the destination log file of the logging identifier KIM to log file C and specify that C resides on disk, enter:

  ALTLOG KIM;LOG=C,DISC

Since the keyword parameter, PASS=, was omitted, KIM retains any password previously specified.

Related Information

Commands

CHANGELOG, GETLOG, LISTLOG, SHOWLOGSTATUS

Manuals

User Logging Programmer's Guide System Startup, Configuration, and Shutdown Reference Manual

Feedback to webmaster