• No results found

Working With the RSF Log

In document Remote Software Facility (Page 186-193)

The Work With RSF Log (WRKRSFLOG) command is used to display or print selected RSF log entries. A log entry is generated each time a requester contacts your machine with RSF. Log entries can also be generated each time your machine initiates a request. See Setting Product Defaults for information about changing the logging defaults.

The prompted version of the WRKRSFLOG command is shown below. Click on the image to see command parameter descriptions.

The parameters for the WRKRSFLOG command are described below. Starting date

Indicates which transaction dates to include in the entries that are displayed or printed. The possible values are:

*CURRENT: Transactions from the current date are included.

*FIRST: All transactions from the earliest available date are included.

date: Enter a date in the date format currently in effect for your job. Transactions started

on or after the date specified are included. Ending date

Indicates which transaction dates to include in the entries that are displayed or printed. The possible values are:

*CURRENT: All transactions started on or before the current date are included.

date: Enter a date in the date format currently in effect for your job. Transactions started

on or before the date specified are included. Starting time

Indicates which transaction times to include in the entries that are displayed or printed. The possible values are:

*FIRST: All transactions from the earliest available time are included.

time: Enter a time in hours:minutes:seconds format. Transactions started on or after the

time specified are included. Ending time

Indicates which transaction times to include in the entries that are displayed or printed. The possible values are:

*CURRENT: All transactions started on or before the current time are included. time: Enter a time in hours:minutes:seconds format. Transactions started on or before

the time specified are included. Package

Indicates which RSF package names should be included in the entries that are displayed or printed. The possible values are:

*ALL: All packages are included.

generic-name: Enter a generic package specification. An asterisk (*) in the

specification will match any string of zero or more characters in the name. An underscore (_) in the specification will match any single character in the name. Machine serial number

Indicates which serial numbers should be included in the entries that are displayed or printed. The possible values are:

*ALL: All serial numbers are included.

serial-number: Enter a generic serial number specification. Case is significant. An

asterisk (*) in the specification will match any string of zero or more characters in the name. An underscore (_) in the specification will match any single character in the name. System name

The possible values are:

*ALL: All system names are included.

generic-name: Enter a generic system name specification. Case is significant. An

asterisk (*) in the specification will match any string of zero or more characters in the name. An underscore (_) in the specification will match any single character in the name. Model

Indicates which models should be included in the entries that are displayed or printed. The possible values are:

*ALL: All models are included.

model-name: Enter a generic model specification. Case is significant. An asterisk (*) in

the specification will match any string of zero or more characters in the name. An underscore (_) in the specification will match any single character in the name. User

Indicates which user IDs should be included in the entries that are displayed or printed. Log entries are included if they were generated by the ID specified

The possible values are:

*ALL: All user IDs are included.

user-ID: Enter a generic user specification. Case is significant. An asterisk (*) in the

specification will match any string of zero or more characters in the name. An underscore (_) in the specification will match any single character in the name. Language code

Indicates which language codes should be included in the entries that are displayed or printed. The possible values are:

*ALL: All language codes are included.

language-code: Enter a generic language code specification. Case is significant. An

asterisk (*) in the specification will match any string of zero or more characters in the name. An underscore (_) in the specification will match any single character in the name. Request type

Indicates which request types should be included in the entries that are displayed or printed. The possible values are:

*ALL: All request types are included.

*MSG: Only requests where the requester specified *MSG for "Type of data" are

included.

*CVRLTR: Only requests where the requester specified *CVRLTR for "Type of data"

are included.

*DATA: Only requests where the requester specified *DATA for "Type of data" are

included.

*RETRY: Only retries of previously interrupted requests are included.

Command that generated request

Indicates that requests initiated by a particular command are displayed or printed. The possible values are:

*ALL: Requests initiated by all RSF commands are included.

name: Only requests generated by the command you specify are included.

Error message ID

Indicates which error message IDs should be included in the entries that are displayed or printed. The possible values are:

*ALL: All error message IDs, including blank, are included. *BLANK: Only transactions that ended successfully are included. *NONBLANK: Only transactions that ended in error are included.

message-ID: Enter a generic message ID specification. Case is significant. An asterisk

(*) in the specification will match any string of zero or more characters in the name. An underscore (_) in the specification will match any single character in the name.

Output

The possible values are:

*: Display the list. *PRINT: Print the list.

Detail

Controls the amount of detail shown when printing the list. The possible values are:

*BASIC: A subset of the total information is shown for each log entry. Multiple log

entries are printed per page.

*FULL: All information is shown for each log entry. One log entry is printed per page.

The display that is presented when you specify OUTPUT(*) on the WRKRSFLOG command is shown below.

The following function keys may be used with this display:

F3: Exit without updating. F5: Refresh the display. F12: Cancel.

The fields on the Work with RSF Log display are explained below. Opt

Enter an option number in the "Opt" column beside a list entry, and press Enter to perform a function on the list entry. You may enter options beside several list entries before pressing Enter. The options for the list entries are processed in turn when you press Enter. The following is a list of options and their functions.

4=Delete: A display is presented allowing you to confirm your choices for delete. When

you press Enter a second time, the entries are deleted.

5=Display: Detailed information about the entry is displayed.

8=Error message: Display the text for the error message associated with the log entry. 12=Work with job: Work with the job that generated the log entry.

Package

The name of the RSF package that the log entry pertains to is shown. Serial #

The serial number of the requesting machine. Start Date

The date the transaction started. Start Time

The time the transaction started. End Time

The time the transaction ended. Error Message ID

This column indicates whether the transaction ended in error. If this column is blank, the transaction ended normally. Otherwise, the column contains the message ID for the error message that caused the transaction to end in error. The text for all RSF messages can be found in message file RSFMSG in library RSF. To display a message description, key 8 beside the entry and press Enter.

For more information about the following command, prompt the command and press F1 to view the on-line help text:

Purge RSF Log (PRGRSFLOG)

In document Remote Software Facility (Page 186-193)