Previous Topic

Next Topic

Book Contents

Book Index

Automation Log Show Screen and Automation Log Search Screen Windows

The Automation Log Show Screen and Automation Log Search Screen windows in the Automation Log screen enable you to create or modify a filter.

For more information about the Automation Log Show Screen window, see the following topic, "Automation Log Show Screen Window."

Automation Log Show Screen Window

Figure 44 Automation Log Show Screen Window

FILTER: +-----------------  AUTOMATION LOG SHOW SCREEN --------------------(OL)

COMMAND | FILTER CICS       SAVE Y (Y/N)  DESC: CICS ONLY                     |

SHOW LI | ID                                                                  |

DATE    | JNAME cics*                                                         |

290200  | JOBID                                                               |

290200  | SYSTEM                                                              |

290200  | USERID                                                              |

290200  | CONSOLE                                                             |

290200  | CONID                                                               |

290200  | MCSF                                                                |

290200  | DESC                                                                |

290200  | ROUTE                                                ROUTE FFFF Y   |

290200  | TSO STC JOB MVS CICS IMS MSG CMD LOG TRACE SHOUT SMS SYSOUT OMG     |

290200  |  Y   Y   Y   Y   Y    Y   Y   Y   Y   Y     Y     Y   Y      Y      |

290200  | ENVIRONMENT                                                         |

290200  | SUPPRESSED     Y   |   NOT SUPPRESSED   Y                           |

290200  | HANDLED        Y   |   NOT HANDLED      Y                           |

290200  | REISSUED       Y   |   NOT REISSUED     Y                           |

290200  | REPLY  CONTROLO  MULTILINE                                          |

290200  | ONLY     ONLY      ONLY                                             |

290200  |   N        N         N                                              |

290200  +---------------------------------------------------------------------+

290200 143323 CONSOLE   798                                      PGN=005  DMN=

COMMANDS: ALL  LIMIT  LOCATE  SHOW  SHPF  SWAP  TRACE  WRAP  AUTO      15.19.19   

The Automation Log Show Screen window contains the fields shown in Table 60.

Table 60 Fields of the Automation Log Show Screen Window

Field

Description

FILTER

The user-assigned filter name. The name specified in the Filter field can be modified.

If the filter has unsaved changes in memory, an asterisk (*) appears to the right of the filter name. For more information see "Exiting the Automation Log Screen Filter Window" in Display Filters Window.

SAVE

Whether to save modifications to the filter when closing the window. Valid values are:

  • Y (Yes)
  • N (No)

DESC

The user-assigned description of the filter. This description can be modified.

The fields in Table 61 define the selection criteria to be applied to the screen. Specify the appropriate selection criteria.

Table 61 Selection Criteria of the Automation Log Show Screen Window

Criteria

Description

ID

Includes only records selected according to the ID field (the first word of the message or the command). Up to four masks can be specified.

Examples

  • ID IST* DFH* — Displays only VTAM and CICS messages.
  • ID F MODIFY — Displays only MODIFY commands.

When the Dealias feature is active, records of type C (Command) are selected after the command has been dealiased while records of type M (Message) are selected by matching their ID value to that of the ID field in the SHOW OPTION window.

For further information on the Dealias feature, see ON COMMAND: Message/Event Selection Parameter, and List of Commands for Which Dealiasing Is Supported.

Example 1

E is specified in the ID field of the SHOW OPTION window. The following records are selected:

  • E commands
  • RESET commands
  • Messages whose first word is E

ID

(continued)

Example 2

RESET is specified in the ID field of the SHOW OPTION window. The following records are selected:

  • E commands
  • RESET commands
  • Messages whose first word is RESET

JNAME

Includes only records selected according to the JOBNAME field. Up to four masks can be specified.

Example

JNAME M88* M23 displays only records whose job name is M23 or starts with M88.

JOBID

Includes only records selected according to the JOBID field. Only one value can be specified.

Note: In order to select a job whose job ID is longer than five digits, specify the last five digits of the job ID.

Example 1

JOBID 234 displays only the records whose job ID is, or ends with, 00234.

Example 2

JOBID 23456 displays only the records whose job ID is, or ends with, 23456 (such as 0123456).

SYSTEM

Includes only records selected according to the SYSTEM field. Up to four system names or masks can be specified. Each system name can be a maximum of eight characters in length.

Example

SYSTEM SYSA* displays only records whose system name is SYSA or is prefixed by SYSA.

USERID

Includes only records selected according to the USERID field. Up to four user IDs or masks can be specified. Each user ID can be a maximum of eight characters in length.

Example

User ID N25* displays only records where the user ID is N25 or is prefixed by N25.

CONSOLE

Includes only records selected according to the CONSOLE field. Up to four console IDs or masks can be specified. Each console ID can be a maximum of eight characters in length.

Example

CONSOLE N25* displays only records whose console ID is N25 or is prefixed by N25.

CONID

Includes only records which have the specified console ID. Up to three values can be specified.

Example

CONID 10 displays records intended for the console with the ID 10.

MCSF

Includes only records selected according to the MCS flags field. Up to three values can be entered.

Example

MCSF 13 displays WTO messages with the MCS flag 13.

DESC

Includes only WTO messages with the specified descriptor codes. Up to three values can be specified.

Example

DESC 1 8 16 displays messages with a descriptor code of 1, 8, or 16.

ROUTE

Includes only WTO messages coming from the specified route codes. Up to eight values can be specified.

Example

ROUTE 1 90 displays messages with a route code of 1 or 90.

Note: Messages that are sent to all route codes may not be displayed, depending on the value specified in the ROUTE FFFF field (described in this table).

ROUTE FFFF

Indicates whether messages sent to all routes should be displayed, in addition to the messages sent to the routes specified in the ROUTE field (described in this table).

TSO
STC
JOB

Selection is based on the JTYPE field. Valid values for each of these fields are:

  • Y (Yes) — Select the record for display if the selection field name matches the JTYPE field.
  • N (No) — Omit the record from display if the selection field name matches the JTYPE field.

Insert the value Y into at least one of these fields.

Example

TSC   STC   JOB

Y    N     N

displays only TSO users related records.

MVS
CICS
IMS

Selection is based on the ENVIR field. Valid values for each of these fields are:  

  • Y (Yes) — Select the record for display if the selection field name matches the ENVIR (Environment) field.
  • N (No) — Omit the record from display if the selection field name matches the ENVIR (Environment) field.

Insert the value Y into at least one of these fields.

Example

MVS   CICS   IMS

N     Y      N

shows only records intercepted by the CICS interface.

Note: CICS and IMS messages are not written to the Syslog. They are intercepted by the Control-O interface and written to the Automation Log file.

MSG
CMD

Selection is based on the TYPE field. Valid values for each of these fields are:

  • Y (Yes) — Select the record for display if the selection field name matches the TYPE field.
  • N (No) — Omit the record from display if the selection field name matches the TYPE field.

Insert the value Y into at least one of these fields.

Example

MSG   CMD

  N        Y

causes commands (and not messages) to be displayed.

LOG
TRACE
SHOUT

Selection is based on the REC.TYPE field. Valid values for each of these fields are:  

  • Y (Yes) — Select the record for display if the selection field name matches the REC.TYPE field.
  • N (No) — Omit the record from display if the selection field name matches the REC.TYPE field.

Insert the value Y into at least one of these fields.

Example

LOG   TRACE   SHOUT

Y      N       N

displays only Syslog (Type S) records.

SMS
SYSOUT
OMG

Selection is based on the ENVIR field. Valid values are:

  • Y (Yes) — Select the record for display if the selection field name matches the ENVIR (Environment) field.
  • N (No) — Omit the record from display if the selection field name matches the ENVIR (Environment) field.

Insert the value Y into at least one of these fields.

Example

SMS   SYSOUT   OMG

  N          Y            Y

Shows only records intercepted by the SYSOUT and OMEGAMON interfaces.

ENVIRONMENT

Selection is based on the ENVIR field. Only messages and commands from the specified environments are displayed. Up to nine environment IDs can be specified.

If no value is specified in this field, messages and commands from all environments are displayed.

SUPPRESSED
NOT SUPPRESSED

Selection is based on the SUPPRESS field. Valid values for each of these fields are:

  • Y (Yes) — Select the record for display if the selection field name matches the SUPPRESS field.
  • N (No) — Omit the record from display if the selection field name matches the SUPPRESS field.

Insert the value Y into at least one of these fields.

Example

SUPPRESSED Y NOT SUPPRESSED N

displays only records about suppressed messages and commands.

HANDLED/NOT HANDLED

Selection is based on the HANDLED field. Valid values for each of these fields are:

  • Y (Yes) — Select the record for display if the selection field name matches the HANDLED field.
  • N (No) — Omit the record from display if the selection field name matches the HANDLED field.

Insert the value Y into at least one of these fields.

Example

HANDLED Y NOT HANDLED N

displays only records of HANDLED messages and commands.

REISSUED/NOT REISSUED

Selection is based on the J3FLG field. Valid values for each of these fields are:

  • Y (Yes) — Select the record for display if the selection field name matches the J3FLG field.
  • N (No) — Omit the record from display if the selection field name matches the J3FLG field.

Insert the value Y into at least one of these fields.

Example

REISSUED Y NOT REISSUED N

displays JES3 or Sysplex reissued messages.

This option is useful when it is necessary to sort out the locally issued messages from the reissued ones out of the global processor Automation Log.

REPLY ONLY

Selection is based on the REPLY field. Valid values are:

  • Y (Yes) — Select records for display if the records have non-zero REPLY IDs.
  • N (No) — Record selection is not dependent on the REPLY field.

Example

REPLY ONLY Y

displays only the WTOR message records and the commands that answer them.

CONTROLO ONLY

Selection is based on the CTO field. Valid values for this field are:

  • Y (Yes) — Select the record for display if Y is specified in the CTO field of the record.
  • N (No) — Record selection is not dependent on the CTO field.

Example

CONTROLO ONLY Y

displays only records of messages and commands issued by Control-O.

MULTILINE ONLY

Selection is based on the MULTILN field. Valid values for this field are:

  • Y (Yes) — Select the record for display if the MULTILN field of the record is equal to F, M, or L.
  • N (No) — Record selection is not dependent on the MULTILN field.

Example

MULTILINE ONLY Y

displays only records of multi-line WTO Messages.

Automation Log Search Screen Window

Figure 45 shows the Automation Log Search Screen Window.

Figure 45 Automation Log Search Screen Window

FILTER:                      -> AUTOMATION LOG SMF=OS35 <--------< D >-----(OL)

COMMAND ===>                                                    SCROLL===> CRSR

SHOW/SEARCH ON => SEARCH                                   DATE 080701 - 080701

DATE   TIME   JOBNAME   ------------------ M E S S A G E ----------------------

080701 122933 I03       V 075,CONSOLE                                         

080701 +------------  AUTOMATION LOG SEARCH SCREEN --------------(OL)+        

080701 | FILTER CICS       SAVE   (Y/N)  DESC: CICS ONLY             |        

080701 |                                                             |ECIFICAT

080701 |  Logical   Character Range  Character             Boolean   |        

080701 |  Operator                   String                Operator  |        

080701 |            From      To                                     |        

080701 |  --------  -----     -----  --------------------  --------  |ECIFICAT

080701 |  EQ        001       128    CONSOLE               OR        | ARE NON

080701 |  EQ        001       003    CTO                             |OLE CTOP

080701 |                                                             | ARE NON

080701 |                                                             |        

080701 |                                                             |OLE CTOP

080701 |                                                             |TROL-O S

080701 +------------------------------------------------------------ +TROL-O S

080701 123025 CONSOLE   CTO282I TEST NUMERO 3 DE MESSAGES POUR     CONTROL-O S

080701 123025 CONSOLE   CTO282I TEST NUMERO 4 DE MESSAGES POUR     CONTROL-O S

080701 123025 CONSOLE   CTO282I TEST NUMERO 5 DE MESSAGES POUR     CONTROL-O S

080701 123025 CONSOLE   CTO282I TEST NUMERO 21 DE MESSAGES POUR     CONTROL-O

080701 123025 CONSOLE   CTO282I TEST NUMERO 22 DE MESSAGES POUR     CONTROL-O

080701 123025 CONSOLE   CTO282I TEST NUMERO 23 DE MESSAGES POUR     CONTROL-O

080701 123026 CONSOLE   CTO282I TEST NUMERO 24 DE MESSAGES POUR     CONTROL-O

080701 123026 CONSOLE   CTO282I TEST NUMERO 25 DE MESSAGES POUR     CONTROL-O

COMMANDS: ALL  LIMIT  LOCATE  SHOW  SHPF  SWAP  TRACE  WRAP  AUTO  '/' 18.47.07

The Automation Log Search Screen window contains the fields shown in Table 62.

Table 62 Fields of the Automation Log Search Screen Window

Field

Description

FILTER

The user-assigned name of the filter. The name specified in this field can be modified.

If the filter has unsaved changes in memory, an asterisk (*) appears to the right of the filter name. For more information, see "Exiting the Automation Log Screen Filter Window" in Display Filters Window.

SAVE (Y/N)

Whether to save modifications to the filter when closing the window. Valid values are:

  • Y (Yes)
  • N (No)

DESC.

The user-assigned description of the filter. This description can be modified.

The following fields define the logical (Boolean) relations to be applied to the screen. Up to five logical relations can be specified. Only records that match all relations are displayed.

Table 63 Logical relations of the Automation Log Search Screen Window

Field

Description

Logical Operator

Defines the current logical relation. Valid values are

  • EQ — equal to
  • NE — not equal to
  • LT — less than
  • GT — greater than
  • LE — less than or equal to
  • GE — greater than or equal to

Character Range

From       To

The range of positions for the first argument of the logical relation. For more information, see "Character Range Interpretation" below.

  • From — first position
  • To — last position

Character String

Second argument of the logical relation. From 1 through 20 characters.

Boolean Operator

Boolean value that connects the current logical relation with the next one. Valid values are

  • AND
  • OR

Character Range Interpretation

The character range values defined by the From and To fields vary depending on the logical operator they are used with, as follows.

Parent Topic

Filtering the Automation Log Screen Display