Activity Log Options

The following options can be applied when you are building a parameter string, or selected when you are in screen menu mode.

Note: The option headings are those used for a parameter string. Valid abbreviations and any host type restrictions are shown in parentheses. Where the option names on the parameter screen differ, this is explicitly stated.

ACTIVITY (ACT)

The syntax in parameter mode is:

ACTIVITY

When applied, other options are ignored. This option selects logging of:

Startups and closedowns of built applications and Reports (BOJs and EOJs)
Comment records
Changes to Administration options (for example, :MAX, :MIN commands)

BOJ (BOJ)

The syntax in parameter mode is:

BOJ

This option is displayed on the parameter screen as BOJ/EOJ.

When applied, other options are ignored. This option selects logging of startups and closedowns of built applications and Reports (BOJs and EOJs).

COMPRESS (COM)

The syntax in parameter mode is:

COMPRESS

This option causes output of data to be compressed. Any alphanumeric data containing all spaces is displayed as one space. Null numeric attributes for which zero suppression is in effect are displayed with one zero. By default, each data value is separated from the next by five blanks. With the COMPRESS option, only one space is left between attributes.

DATE (DAT)

The syntax in parameter mode is:

DATE dd/mm

This option causes the records for the date specified to be included. The dd value gives the day, and mm gives the month.

DATEUS (DUS)

The syntax in parameter mode is:

DATEUS mm/dd

This option (DATE U.S. on the parameter screen) causes the records for the date specified to be included. The date must be specified in U.S. format. The mm value gives the month, and dd gives the day.

DBSTATS (DBS)

The syntax in parameter mode is:

DBSTATS

This option causes DMS statistics to be included. When used with STATISTICS, total DMS activity is shown. When used with a log listing activity, READS and WRITES are reported separately for each transaction.

DMACTIVITY (DMA)

The syntax in parameter mode is:

DMACTIVITY nn

This option sets the minimum number of DMS activities (nn) performed on behalf of a transaction before the transaction appears in an EXCEPTION Report. Refer to EXCEPT option for more information.

DOUBLE (DOU)

The syntax in parameter mode is:

DOUBLE

This option causes output lines to be double-spaced.

EOP

The syntax in parameter mode is:

EOP nn

This option (END OF Page on screen) sets the number of printed lines per page to the number specified. By default, it is 60.

ERRORS (ERR)

The syntax in parameter mode is:

ERRORS

This option causes only rejected records to be listed.

EXCEPT (EXC)

The syntax in parameter mode is:

EXCEPT

This option (EXCEPTIONS on screen) reports on only those transactions that exceeded the limits specified in the DMACTIVITY and SECONDS options.

EXPAND (EXP)

The syntax in parameter mode is:

EXPAND

This option produces an expanded list of statistics. When this option is specified, the STATS option must also be specified. This option displays the statistics of Ispecs for each station.

FROM

The syntax in parameter mode is:

FROM hh : mm

This option (FROM TIME on screen) lists those records entered in the log after the time specified. The hh value gives the hour required, and mm gives the minutes.

INCLUDE (INCL)

The syntax in parameter mode is:

INCLUDE nnnnnn

This option is used with SKIP to select a range of up to 999,999 physical records, of which only the transaction records are printed. The range for the nnnnnn value is from 1 to 999999.

Note: Log records that are not transactions are not printed. Refer to FROM and SKIP options.

The INCLUDE option identifies the end point of records to be included, while the SKIP option identifies the start point. If only an INCLUDE option is entered, the start point is 1.

For example, to select the range of records 350 to 2000, enter the following:

SKIP 0350 INCLUDE 2000

Ispec

The syntax in parameter mode is:

ISPEC ispec

This option (Ispec NAME on screen) lists records for the specified Ispec ispec.

Maint

The syntax in parameter mode is:

MAINT maint

This option (Maint TYPE on screen) lists records which match the specified Maint value maint (for example ,Add).

The syntax in parameter mode is:

MORE

If you are selecting screen options, the MORE (ANOTHER Run on screen) option presents another parameter screen. MORE (and ANOTHER Run) do not operate if any Exclusive Options have been set.

NOOPTIONS

The syntax in parameter mode is:

NOOPTIONS

This option (NO OPTIONS on screen) prevents a list of the current options from being printed. By default, your selected options are listed at the top of the log listing.

OUTSTANDING (OUT)

The syntax in parameter mode is:

OUTSTANDING

This option lists unprocessed input only. When it is applied, all other options are ignored.

PACK

The syntax in parameter mode is:

PACK

This option (PACK NAME on screen) specifies the pack on which the LINCCNTL and LINCGLI files reside for the application whose log is being printed.

PERIOD (PER)

The syntax in parameter mode is:

PERIOD

This option specifies the time period covered by the log. It gives the starting and finishing dates and times for the log specified, and any other options are ignored. For specific period requirements, use the TO and FROM commands.

REPORT (REP)

The syntax in parameter mode is:

REPORT report

This option (REPORT NAME on screen) lists log records for the specified Report. When it applies, all other options are ignored.

RETAIN (RET)

The syntax in parameter mode is:

RETAIN

If this option (RETAIN FILE on screen) is used with the STATS option, the log statistics file is retained on disk, making it available for further analysis by a user-written program.

SECONDS (SEC)

The syntax in parameter mode is:

SECONDS nnnnn

This option (TIME IN SECONDS on screen) is used with the EXCEPT command, to report on any transaction with a response time exceeding the nnnnn value specified.

If entered as part of a parameter string, acceptable values are in the range 0.10 through 99.99. If the decimal point is not entered, it is assumed that the value entered is decimal in the range 0.10 through 0.99. If more than two decimal places are entered, the error message Invalid value given for SECONDS is displayed.

SKIP

The syntax in parameter mode is:

SKIP nnnnnn

This option causes the specified number of physical log records (indicated by the nnnnnn value) to be skipped. The valid range is from 1 to 999999. Refer to INCLUDE option, which identifies the end point of records to be included, while the SKIP option identifies the start point. If only a SKIP option is entered, the end point is the end of the file.

For example, to select the range of records 350 through 2000, enter the following:

SKIP 0350 INCLUDE 2000

STATS (STA)

The syntax in parameter mode is:

STATS

This option (STATISTICS on screen) prints statistics along with the log listing. Two or more types of statistics are listed. The first listing shows input statistics by Ispec. The second listing shows input statistics by station. You might also obtain further types of listing by selecting one or more of the EXPANDED, UPDATE, and TIME options. The Log statistics are also written to a file. Refer to Activity Log Statistics File for more information.

STATS (STA) ONLY

The syntax in parameter mode is:

STATS ONLY

This option (STATISTICS ONLY on screen) prints statistics only. A log listing is not printed, but the log statistics are written to a disk file. Use the RETAIN option to keep this file for later analysis. Refer to Activity Log Statistics File for more information.

STATION (STN)

The syntax in parameter mode is:

STATION station

This option (STATION NAME on screen) lists log records for the specified station or interface program. The value station specified might be the name of the required station, GLI, or OFF (for GLI and Offline interfaces, respectively). Refer to Backup, Recovery, and Remote Database Facility for more information on GLI and Offline.

SUBSYSTEM (SUB)

The syntax in parameter mode is:

SUBSYSTEM subsystem

This option (SUBSYS NO/NAME on screen) lists log records for the specified subsystem name or number, or selects the subsystem for other options.

TIME (TIM)

The syntax in parameter mode is:

TIME

This option includes the average times for transactions in the statistics. The STATS option must also be selected for average times statistics.

The syntax in parameter mode is:

TO hh : mm

This option (TO TIME on screen) lists records with a time less than that specified. The hh value gives the hours, and mm gives the minutes.

UPDATE (UPD)

The syntax in parameter mode is:

UPDATE

This option lists COMSTP program (subsystem) statistics. The STATS option must also be selected.

USERCODE

The syntax in parameter mode is:

USERCODE

This option specifies the usercode of the LINCCNTL file for the application whose log is to be printed. This is used with the PACK option, to locate the LINCCNTL file. If not entered, the usercode of the CANDE session or the usercode defined to the ODT is used. This option must be input as a parameter if the Log program is initiated from the ODT.

If your application is not usercoded, and your LINCCNTL file exists under a usercode of asterisk (*), enter a usercode of spaces. The Log program then looks first under the usercode from which it is running, then under the asterisk (*) usercode.