SNAX/APC Configuration and Management Manual

Introduction to SCF for SNAX/APC
SNAX/APC Configuration and Management Manual—138787
6-5
Objects
If the command pertains to an object, it is followed immediately by the object type and
the object name. For example, the following command aborts the LU object named
LU01:
ABORT LU $APC01.LU01
The following command aborts a partner LU named CICSLU62:
ABORT PTNR-LU $APC01.LU01.CICSLU62
If additional information is required, the object name is followed by a comma and the
parameters required to further specify the action to be taken. For example, the following
command changes the value of the SESSIONCONTROL attribute for a transaction
program (TPN) named ACCT on LU01:
ALTER TPN $APC01.LU01.ACCT, SESSIONCONTROL NO
Many SCF commands permit the use of the command parameters SUB and SEL. You
can use SUB to specify which subordinate objects the command affects. For example,
you may want to abort all the PTNR-LU (partner LU) objects subordinate to an LU
(local LU). One way to do this is with the following command:
ABORT LU $APC01.LU01, SUB ONLY
For some subsystems, you can use the SEL parameter to specify that the command is
effective only if the object or objects are in the specified state. A command like the
following is used to do this:
STATUS PTNR-LU $APC01.LU01.CICSLU62, SEL STARTED
In some commands that provide displayed information, such as the INFO and STATUS
commands, you can specify the DETAIL keyword to obtain a more lengthy, detailed
information display.
Specific information about the format of each SCF command appears later in this
manual in Section 8, SCF Commands for SNAX/APC
. The syntax of SCF commands
that are not subsystem-specific is given in the Subsystem Control Facility (SCF)
Reference Manual.
Objects
SCF controls a wide variety of data communications subsystems whose individual
components are called objects. Each object has an object type and an object name. The
object type describes the type of the object, such as LU (logical unit), PTNR-LU
(partner, or remote, LU), or PROCESS. The object name uniquely identifies an object
within the system.
Object names follow a consistent set of naming conventions. The name of the
PROCESS object, which is created by the operating system RUN command, consists of
a dollar sign ($) followed by a letter and from zero through four alphanumeric
characters. Other objects are added to the subsystem by using the SCF ADD command,
and the object names reflect the hierarchical nature of the objects.
As an example, the object name for an PTNR-LU object has three parts: the name of the
SNAX/APC process, the name of the local LU with which the partner LU is associated,