Implementing Activity Logs › Online Logging Procedure

Online Logging Procedure

The default online logging procedure is $LOPROC. This procedure is designed to work with the online browsing procedure $LOBROW.

You can replace the $LOPROC and $LOBROW procedures with your own customized NCL procedures. Alternatively, you can write a customized log browsing procedure to present the supplied data files (from $LOPROC) in your own format.

Structure of Supplied Log Files

The supplied log files (NMLOG01, NMLOG02, and NMLOG03) have the following physical file structure:

• The record key has the following format:

  YYYYMMDDHHMMSSHSnnnn
  

  nnnn=1000 + (reset every 100th of a second) and key length=20 bytes

• A record has the following contents

  ORIGIN

  Contains the terminal name.

  REGION

  Contains the user ID.

  TEXT

  Contains the message text to display in the activity log.

  MSGATTR

  Contains the 2-byte color/highlight indicator. Colors are R=red, Y=yellow, W=white, B=blue, G=green, T=turquoise, or P=pink. Highlight values are R=reverse, B=blink, U=underscore, or N=none.

  ORIGTIM

  Contains the time at the remote domain.

  ORIGDMN

  Contains the name of the originating domain.

  ORIGSRC

  Contains the ID of the remote terminal.

Note: For more information, see the following references:

• The description of the &FILE OPEN verb in the Network Control Language Reference Guide.
• The Network Control Language Programming Guide.

How You Write Logging and Browsing Procedures

To write your own customized NCL procedure to replace $LOBROW, use the &FILE OPEN statement with FORMAT=DELIMITED.

You can store your log records in whatever file format you want. Your log browsing procedure must match this file format.

Note: For more information, see the descriptions of the following verbs in the Network Control Language Reference Guide:

• &LOGREAD
• &LOGCONT
• &LOGDEL

Implement Logging and Browsing Procedures

After you write your own browsing procedure or your own logging and browsing procedures, you implement them for use.

To implement your procedures

1. Enter U next to the LOGFILES parameter group in Customizer.
2. Update the relevant fields.
3. Press F6 (Action).

   Your procedures are used for logging and browsing.

4. Press F3 (File).

   Your changes to the parameter group are saved.