Implementing Activity Logs › Replace Your Online Logging Procedure

Replace Your Online Logging Procedure

The default online logging procedure is $LOPROC. This procedure is designed to work in conjunction 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.

Write a Log Browsing Procedure

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

The physical file structure of the supplied log files (NMLOG01, NMLOG02, and NMLOG03) is as follows:

• Key Format

  YYYYMMDDHHMMSSHSnnnn
  

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

• Record Contents
  • ORIGIN

    Terminal name

  • REGION

    User ID

  • TEXT

    Message text to display in the activity log

  • MSGATTR

    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=uscore, or N=none.

  • ORIGTIM

    Remote domain time

  • ORIGDMN

    Originating domain name

  • ORIGSRC

    Remote terminal ID

For more information, see the following:

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

Write Logging and Browsing Procedures

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

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

If you write your own browsing procedure or your own logging and browsing procedures, you need to implement them.

To implement your procedures, update the LOGFILES parameter group in Customizer with your parameter names and then action the group.