HP 3000 Manuals HP 3000 Manuals
ALTLOG
Alters the attributes of an existing user logging identifier.
Syntax
ALTLOG logid [;LOG=logfile {,DISC}] [;PASS=password] [{;AUTO }]
[ {,TAPE}] [{;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 (32650-60012)
System Startup, Configuration, and Shutdown Reference
Manual (32650-90042)