Description

z/OS MVS Programming: Authorized Assembler Services Reference ALE-DYN

Description

z/OS MVS Programming: Authorized Assembler Services Reference ALE-DYN
SA23-1372-00

The CPF (command prefix facility) macro allows you to manage command prefixes. A command prefix enables an operator to enter a command from a system in a sysplex, and route that command to the appropriate subsystem for execution. The CPF macro allows an application to use command prefixes to associate an operator command with a “target” system. The command prefixes are available to any system in the sysplex.

Use the CPF macro to:

Define a new command prefix
Delete an existing command prefix
Redefine an existing command prefix for a system or owner name.

The macro has a list and an execute form, but no standard form. The parameters are explained in detail on the execute form of the macro.

For more information on the CPF macro, see z/OS MVS Programming: Authorized Assembler Services Guide.

Environment

The requirements for the caller are:

Environmental factor	Requirement
Minimum authorization:	One of the following: Supervisor state APF-authorized PSW keys 0-7
Dispatchable unit mode:	Task
Cross memory mode:	PASN=HASN=SASN
AMODE:	24- or 31-bit
ASC mode:	Primary
Interrupt status:	Enabled for I/O and external interrupts
Locks:	No locks held
Control parameters:	Must be in the primary address space

Programming requirements

None.

Restrictions

Prefixes cannot be supersets or subsets of existing prefixes. See z/OS MVS Programming: Authorized Assembler Services Guide for details about defining valid prefixes.

Input register information

Before issuing the CPF macro, the caller must ensure that the following general purpose register (GPR) contains the specified information:

Register: Contents
13: The address of an 18-word save area

Output register information

When control returns to the caller, the general purpose registers (GPRs) contain:

Register: Contents
0: Reason code, unless you receive return code X'0C'. In this case, register 0 contains a system completion code or zero.
1: Used as a work register by the system
2-13: Unchanged
14: Used as a work register by the system
15: Return code

When control returns to the caller, the access registers (ARs) contain:

Register: Contents
0-1: Used as work registers by the system
2-13: Unchanged
14-15: Used as work registers by the system

Some callers depend on register contents remaining the same before and after issuing a service. If the system changes the contents of registers on which the caller depends, the caller must save them before issuing the service, and restore them after the system returns control.

Performance implications

None.