gtpo1m6jOperations

ZFMSG-Process Command Characteristics

Use this command to do the following:

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

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.