FILTER Commands - ironstream_for_micro_focus_omi - 7.2

The FILTER commands listed below make use of the Ironstream agent feature that restricts incoming z/OS commands from the server.

SHOW FILTER

Displays all commands in the command filter table. If the table has any entries, then incoming commands are checked against the table’s regular expressions, and only those commands that have a match in the table will be executed. If the command table has no entries, then all commands are executed.

Parameters:

None

Example:

MODIFY VP390,SHOW FILTER

EVO595 Command entered: SHOW FILTER EVO612 No message filters defined EVO612 No alert filters defined EVO609 Command filters:

EVO609 ¬D IPLINFO$ EVO609 ¬D NET,MAJNODES$ EVO609 ¬V NET,ACT,ID=*.

EVO695 VP390 SHOW command processed

FILTER ADD

Adds a message ID to the message filter table or a command to the command filter table.

Messages (MSG)

The message table holds up to 2,000 message IDs by default, and each message ID can be up to 15 characters long and may be specified with a period (.) as a placeholder for any character within the message ID, or with an asterisk(*) at the end of any message ID to match any message with the same beginning character(s).

Multiline messages can be delivered to OMi server for display and logging in three possible formats:

1. By default, the multiple lines will be concatenated together into one single message as seen by OMi server.

2. Prepend a plus sign "+" to the front of the message ID to send the multiple lines as separate messages to OMi server, but with the original message ID prepended to the beginning of all secondary message lines.

3. Prepend a minus sign "-" to the front of the message ID to send the multiple lines as separate messages to OMi server, but without the original message ID added to the beginning of the secondary message lines.

Messages can also be filtered based on the job name or job ID of the job (if any) which issued the message. Job names and job IDs may be specified with a period(.) as a placeholder for any character within the value, or with an asterisk(*) at the end of any value to match any job name or job ID with the same beginning character(s). If job name(s) or job ID(s) are specified for a message ID, then the message ID will only pass the filtering if the given job name(s) or job IDs are attached to that message.

For messages that have a reply number attached to the front of the message, skip over the reply number and use the message ID. For example, to capture this MVS message:

*02 IEF238D TAPEBKUP - REPLY DEVICE NAME OR 'CANCEL'.

Add "IEF238D" to the message filter. The reply number will be added to the front of the message when it is passed on to OMi sever for use in automatic actions.

Use the "REXX" option to automatically call a Rexx program instead of sending the message to the OMi server. The program will be called with one parameter: the message text, the job name, and the job ID, separated by carriage return characters (x'0A'). (If there is no job name or job ID, these fields are filled in with "N/A"). See the sample programs JOBSUB, PARSEMSG, and SMFDUMP in the EV390 SAMP dataset for examples on how to set up automation programs.

Commands (CMD)

The command filter table hold up to 200 commands by default. Each command may be specified with regular expressions to broaden or narrow the scope of commands that may be executed by the Ironstream job.

Syntax

FILTER ADD MSG [+|-]msgid [JOBNAME=(jobname[,jobname]...)] [JOBID=(jobid[,jobid]...)] [REXX=script]

FILTER ADD CMD command

Examples

• Permit message IST105I to be passed on to OM server:

MODIFY VP390,FILTER ADD MSG IST105I

EVO595 Command entered: FILTER ADD MSG IST105I EVO610 Message filter IST105I added

• Permit any message that has “HASP” in the second through fifth character of the message ID:

MODIFY VP390,FILTER ADD MSG .HASP*

EVO595 Command entered: FILTER ADD MSG .HASP* EVO610 Message filter .HASP* Added

• Permit any message that begins with “QWE” and was issued by a job with a name that begins with either “BB” or “CC”:

MODIFY VP390,FILTER ADD MSG QWE* JOBNAME=(BB*,CC*)

EVO595 Command entered: FILTER ADD MSG QWE* JOBNAME=(BB*, CC*)

EVO610 Message filter QWE* Added

• Call the Rexx program SMFDUMP whenever a message IEE391A message is received:

MODIFY VP390,FILTER ADD MSG IEE391A REXX=SMFDUMP

EVO595 Command entered: FILTER ADD MSG IEE391A REXX=SMFDUMP

EVO610 Message filter IEE391A Added

• Allow the Ironstream IBM Z agent to only accept VTAM “Display Net” commands:

MODIFY VP390,FILTER ADD CMD D NET,*

EVO595 Command entered: FILTER ADD CMD D NET,* EVO610 Command filter D NET,* Added

FILTER DEL

Deletes a message ID from the message filter table or a command from the command filter table. Specifying ALL deletes all filters from the message table and the command table.

Messages (MSG)

It is not necessary to specify the optional "+" or "-" that is prepended to a message ID. If the JOBNAME, JOBID, or REXX parameter is added, those attributes will be deleted from the filter table entry, but the primary message ID will remain in the table.

Commands (CMD)

Specify the command to be removed exactly as is it shown in the SHOW FILTER output.

Syntax:

FILTER DEL MSG msgid JOBNAME=(jobname[,jobname]...)] [JOBID=(jobid[,jobid]...)] [REXX=script]

FILTER DEL CMD command

Examples

MODIFY VP390,FILTER DEL MSG IST105I

MODIFY VP390,FILTER DEL MSG NNN456I JOBNAME=(MYJOB)

MODIFY VP390,FILTER DEL CMD DISPLAY*

MODIFY VP390,FILTER DEL ALL

SUPPRESS Commands

The SUPPRESS commands enable you to control the printing of VP390 messages that announce subtask connections, disconnections, or other changes internal to the VP390 address space. Message suppression may be useful in reducing the number of VP390 messages written to the system log.