ALTLOG

Generated from C.60.01 /SYS/PUB/CICAT last modified on Thu Jan 11 09:18:52 2001

Back to Main Index


ALTLOG


     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, 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.  Refer to the CHANGELOG command.

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


OPERATION


     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. You must have system supervisor (OP) or User
     Logging (LG) capability to execute ALTLOG. 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 will be broken.

     This command may be issued from a session, job, program, or in
     BREAK.  Pressing [Break] has no effect on this command.  It
     requires User Logging (LG) capability.


EXAMPLE(S)


     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 not included, KIM
     retains any password previously specified.


ADDITIONAL INFORMATION


Commands:   CHANGELOG, GETLOG, LISTLOG, SHOWLOGSTATUS

Manuals :   MPE/iX Intrinsics Reference Manual (32650-90028)
            System Startup, Configuration, and Shutdown
              Reference Manual (32650-90042)

Back to Main Index