Use this command to do the following:
- Create a new user-defined command
- Change the operating characteristics of a command
- Display the operating characteristics of a command
- Delete a user-defined command
- Delete any changes that were made to a command that was provided by the
TPF system.
A user-defined command is a command that you define and
create. It is not provided by the TPF system.
Requirements and Restrictions
You can enter this command from any subsystem only if the multiple database
function (MDBF) is generated.
Format
- Add
- creates a new user-defined command.
- Note:
- After you create a new user-defined command, use the CHANGE parameter to
define the operating characteristics.
- Change
- changes the operating characteristics of a command.
- Display
- displays the operating characteristics of a command.
- Remove
- deletes a user-defined command or deletes the changes that were made to a
command that was provided by the TPF system.
- Zcode
- is a command, where code is a 1- to 4-character alphanumeric
secondary action code (SAC).
- Note:
- If you do not specify a secondary action code, a blank character is
assumed.
- Program-name
- is the 4-character name of the service program to be started by the new
command.
- Activate-
- specifies the activation type to be used when passing control to the
service program.
- ENTDC
- specifies an activation type of ENTDC.
- ENTNC
- specifies an activation type of ENTNC.
- ALL
- displays all of the commands that were created or changed, deletes all of
the user-defined commands, or deletes all of the changes that were made to
commands that are provided by the TPF system.
- NO
- turns off the following operating characteristics.
- opchar
- is one or more of the following operating characteristics:
For Command Indicators:
- EP
- The command is valid only in the EP processor.
- BSS
- The command is valid only in the basic subsystem.
- RBS
- Send the command to the basic subsystem for processing.
- SSU
- Use the DBI of the first subsystem user when processing the
command.
- RST
- The command is restricted to authorized CRAS terminals.
- DRM
- Allows the command to be processed in a dormant subsystem user.
- ALL
- The command is allowed from any terminal.
- TST
- The command is allowed only when the system is operating in test
mode.
- PCO
- The command is allowed only from prime CRAS.
For Functional Support Consoles:
- RO
- Send a copy of the response to RO CRAS.
- PRC
- Send a copy of the response to prime CRAS.
- TAPE
- Send a copy of the response to the tape console.
- DASD
- Send a copy of the response to the DASD console.
- COMM
- Send a copy of the response to the communications console.
- AUDT
- Send a copy of the response to the audit trail console.
- RDBS
- Send a copy of the response to the real-time database services (RDBS)
console.
For Additional Indicators:
- STA
- The command is processed using the SNA type A format, which allows you to
enter the command without parameters. This parameter is identical to
the NOSTB parameter.
- STB
- The command is processed using the SNA type B format, which requires you
to enter the command with parameters. This parameter is identical to
the NOSTA parameter.
- USR
- The command is a user-defined command.
Additional Information
- Online help information is available for this command. To display
the help information, enter one of the following:
ZFMSG HELP
ZFMSG ?
- Changes made with this command take effect immediately.
- No conflict checking is performed when you change command
indicators. For example, ALL and PCO can be specified at the same time
but are in direct conflict with each other. Normally, a higher
authorization overrides a lower one. In this example, the command is
allowed only from the prime CRAS. The ALL parameter is ignored.
Examples
The ZANEW command is created in the following example. When you
enter this command, the CVXT program is started.
+--------------------------------------------------------------------------------+
|User: ZFMSG ADD ZANEW PROGRAM-CVXT |
| |
|System: FMSG0002I ZANEW ADDED |
| ZANEW ACTIVATES CVXT VIA ENTDC |
| NO COMMAND INDICATORS SET |
| FUNCTIONAL SUPPORT CONSOLES SET |
| RO - RO CRAS |
| AUDT - AUDIT TRAIL CONSOLE |
| NO ADDITIONAL INDICATORS SET |
+--------------------------------------------------------------------------------+
The operating characteristics of the ZANEW command are changed in the
following example.
+--------------------------------------------------------------------------------+
|User: ZFMSG CHANGE ZANEW RBS DRM NOAUDT |
| |
|System: FMSG0004I ZANEW CHANGED |
| ZANEW ACTIVATES CVXT VIA ENTDC |
| COMMAND INDICATORS SET |
| RBS - ROUTE TO BASIC SUBSYSTEM |
| DRM - ALLOW IN DORMANT SS USER |
| FUNCTIONAL SUPPORT CONSOLES SET |
| RO - RO CRAS |
| NO ADDITIONAL INDICATORS SET |
+--------------------------------------------------------------------------------+
The ZANEW command is deleted in the following example.
+--------------------------------------------------------------------------------+
|User: ZFMSG REMOVE ZANEW |
| |
|System: FMSG0003I ZANEW REMOVED |
+--------------------------------------------------------------------------------+
The operating characteristics defined for the ZNETW command are displayed
in the following example.
+--------------------------------------------------------------------------------+
|User: ZFMSG DISPLAY ZNETW |
| |
|System: FMSG0001I 07.10.37 BEGIN DISPLAY FOR ZNETW |
| ZNETW ACTIVATES CSEA VIA ENTDC |
| COMMAND INDICATORS SET |
| BSS - BASIC SUBSYSTEM ONLY |
| SSU - USE FIRST SUBSYSTEM USER DBI |
| FUNCTIONAL SUPPORT CONSOLES SET |
| COMM - COMMUNICATIONS CONSOLE |
| AUDT - AUDIT TRAIL CONSOLE |
| ADDITIONAL INDICATORS SET |
| STB - USE SNA TYPE 'B' FORMAT |
+--------------------------------------------------------------------------------+
Related Information
See User-Defined Commands for more information about user-defined commands.