INGNTFY
Purpose
INGNTFY allows you to add, change, delete, and display notification operator settings.
Syntax
Parameters
- ON
- Allows the operator who issues the command to receive notifications.
- OFF
- Turns off notifications for the operator who issues the command.
- ADD
- Adds the operator specified in opid
to the list of notification operators, or changes the definition of
the existing operator specified in opid.
Note: Use of the ADD function to change the definition of an existing operator completely deletes the old definition. It is necessary to re-specify all message classes and held message types that you want this operator to retain. This allows you to remove unwanted message classes and held message types from an existing operator.
- DELETE
- Removes the operator specified in opid from the list of notification operators.
- DISP
- Displays information about the operator that is specified in opername, which can also contain a wildcard, such as *abc, abc*, or *abc*.
- QUERY
- Displays information about the operator that is specified in opid.
- opid
- The ID of the operator to add, change, delete, or query.
- your_opid
- The ID of the operator issuing the command.
- CLASS
- The classes of messages the operator is to receive. See IBM Z System Automation Messages and Codes for information about which classes are valid. Up to ten comma-delimited classes, enclosed in parentheses, can be defined for an operator. The default classes are 40 and 80, unless defined otherwise in the automation control file.
- DESC
- An optional description of the operator. If the description contains blanks, commas, or other punctuation characters it must be enclosed in single quotation marks.
- HELDMSG
- The type or types of messages to hold on the operator's screen.
If more than one type is specified, the types should be separated
by commas and enclosed in parentheses. The types are:
- Type
- Meaning
- A
- Immediate Action
- D
- Immediate Decision
- E
- Eventual Action
- I
- Information
- W
- System Wait
- TARGET
- For information on the TARGET parameter, see TARGET Parameter.
- OUTMODE
- For information on the OUTMODE parameter, see OUTMODE Parameter.
For further details of message types and message notifications, see IBM Z System Automation Messages and Codes.
Restrictions and Limitations
Any changes you make using the INGNTFY command are in effect only until the automation control file is reloaded.
The INGNTFY command can only be used when SA z/OS® is initialized.
Security Considerations
The INGNTFY command provides security checking for its parameters.
By default all security roles are authorized to use any of the parameters on the command line or on the panel. This is ensured through granted READ access for profile netid.domain.ING*.* in class NETCMDS.
To restrict the access to the command parameters corresponding profiles must be added to class NETCMDS. The appropriate users must be authorized to access the corresponding profiles, when using any of the parameters on the command line or on the panel.
If SAF security has been turned on (see SECOPTS.CMDAUTH=SAF.xxx), the following resource profiles in class NETCMDS are checked:
| Parameter | Profile | Authority |
|---|---|---|
|
ON OFF ADD DELETE QUERY DISP |
netid.domain.INGRYNTX netid.domain.INGRYNTX.ON netid.domain.INGRYNTX.OFF netid.domain.INGRYNTX.ADD netid.domain.INGRYNTX.DELETE netid.domain.INGRYNTX.QUERY netid.domain.INGRYNTX.DISP |
READ |
If NetViews's Command Authorization Table (CAT) is active (see SECOPTS.CMDAUTH=TABLE.xxx), then add the following PROTECT and PERMIT statements to the environment's CAT for the users or groups that are permitted to use the parameters.
PROTECT *.*.INGRYNTX
PROTECT *.*.INGRYNTX.ON
PROTECT *.*.INGRYNTX.OFF
PROTECT *.*.INGRYNTX.ADD
PROTECT *.*.INGRYNTX.DELETE
PROTECT *.*.INGRYNTX.QUERY
PROTECT *.*.INGRYNTX.DISP
PERMIT group *.*.INGRYNTX
PERMIT group *.*.INGRYNTX.ON
PERMIT group *.*.INGRYNTX.OFF
PERMIT group *.*.INGRYNTX.ADD
PERMIT group *.*.INGRYNTX.DELETE
PERMIT group *.*.INGRYNTX.QUERY
PERMIT group *.*.INGRYNTX.DISP Examples
To turn your messages off, enter ingntfy
off
ingntfy add jim class=43 heldmsg=a AOFKAANT SA z/OS - Command Dialogs Line 1 of 6
Domain ID = IPUN8 ---------- INGNTFY ---------- Date = 06/19/09
Operator ID = NETOP1 Time = 20:12:52
Cmd: A Add C Show/Change settings D Delete O Turn OFF msg receiving
Cmd Operator System Log Rcv Description Classes
--- -------- -------- --- --- ------------------- ----------------------–--
AUTNOTI1 AOC8 Y N MSG AOP 40 80
DON AOC8 Y N DON JONES 40
GIS AOC8 Y Y GISELA STUART 80
MIK AOC8 Y Y MIK SMITH 60
NOTI1 AOC8 N Y 40 41 42 43 44
NOTI2 AOC8 N Y 80 81 82
Command ===>
PF1=Help PF2=End PF3=Return PF6=Roll
PF9=Refresh PF12=Retrieve - The Cmd field lets you specify the command codes shown
on the panel. Type the appropriate letter next to the resource name
and press Enter. The following command codes are available:
- A
- Add a notification operator using the settings of the selected operator.
- C
- Show or change the settings for the selected operator.
- D
- Delete the notification operator.
- O
- Turn off message receiving for the selected notification operator.
- The Operator field shows the operator ID. It is not necessarily defined to NetView.
- The System field shows the name of the system where the operator is defined.
- The Log field shows a Y if the operator was logged on when the command dialog was started, or an N if the operator was not logged on.
- The Rcv (Receive) field shows a Y if the operator was receiving messages when the command dialog was started, or an N if the operator was not receiving messages.
- The Description field shows a description of the operator from either the automation control file or the INGNTFY command dialog.
- The Classes field shows the classes that are assigned to the notify operators.