ZFMSG: Process command characteristics

Use this command to process command characteristics.

With this command you can take the following actions:

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 z/TPF system.

A user-defined command is a command that you define and create. It is not provided by the z/TPF system.

Last updated

Changed for PUT14.
Changed for PUT00.

Requirements and restrictions

You can enter this command from the basic subsystem (BSS) 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 z/TPF system.

Zcode

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

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 z/TPF system.

NO

Turns off the following operating characteristics.

opchar

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.
LPA: The command is authorized to run as a low priority utility. Prefix -LP/ can be used when this command is entered so that the command will run as low priority.

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.
PFA: Positive feedback support is active for this command.
Note: You must enter each command separately.
PFS: This command supports positive feedback with special logging information. The command service routine has been updated to put information into the positive feedback log for each command that will participate in positive feedback support.
UEXT: This command calls a user exit so that additional authorization checks can be performed.
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 commands:
- 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 following example shows that the ZANEW command is created. When you enter this command, the CVXT program is started.

User:   ZFMSG ADD ZANEW PROGRAM-CVXT

System: FMSG0002I 08.59.10 ZANEW ADDED                   
        ZANEW ACTIVATES CVXT VIA ENTDC                   
        NO FUNCTIONAL MESSAGE INDICATORS SET             
        FUNCTIONAL SUPPORT CONSOLES SET                  
         RO   - RO CRAS                                  
         AUDT - AUDIT TRAIL CONSOLE                      
        ADDITIONAL INDICATORS SET _                      
         USR - USER DEFINED MESSAGE

The following example shows that the operating characteristics of the ZANEW command are changed.

User:   ZFMSG CHANGE ZANEW RBS DRM NOAUDT PFA LPA

System: FMSG0004I 09.00.31 ZANEW CHANGED                
        ZANEW ACTIVATES CVXT VIA ENTDC
        FUNCTIONAL MESSAGE INDICATORS SET
         RBS - ROUTE TO BASIC SUBSYSTEM
         DRM - ALLOWED IN DORMANT SS USER
         LPA - LOW PRIORITY AUTHORIZED
        FUNCTIONAL SUPPORT CONSOLES SET _
         RO   - RO CRAS
        ADDITIONAL INDICATORS SET
         PFA - POSITIVE FEEDBACK IS ACTIVE
         USR - USER DEFINED MESSAGE

The following example displays the operating characteristics that are defined for the ZANEW command.

User:   ZFMSG DISPLAY ZANEW

System: FMSG0001I 09.02.39 BEGIN DISPLAY FOR ZANEW      
        ZANEW ACTIVATES CVXT VIA ENTDC
        FUNCTIONAL MESSAGE INDICATORS SET
         RBS - ROUTE TO BASIC SUBSYSTEM
         DRM - ALLOWED IN DORMANT SS USER
         LPA - LOW PRIORITY AUTHORIZED
        FUNCTIONAL SUPPORT CONSOLES SET _
         RO   - RO CRAS
        ADDITIONAL INDICATORS SET
         PFA - POSITIVE FEEDBACK IS ACTIVE
         USR - USER DEFINED MESSAGE

The following example shows that the ZANEW command is deleted.

User:   ZFMSG REMOVE ZANEW

System: FMSG0003I ZANEW REMOVED