7. PARAMETERS › 7.3 Unit Level Parameters › 7.3.2 CICS Processing Options (CICOPS) › 7.3.2.6 GATEWAY ACTIVE and APPLID Statements
7.3.2.6 GATEWAY ACTIVE and APPLID Statements
The GATEWAY ACTIVE statement is used to activate the
processing of CICS Transaction Gateway SMF type 111 records
in a unit where the CA MICS Analyzer Option for CICS is
installed.
The GATEWAY APPLID statement is used to associate four-
character user-selected Gateway ID values with the eight-byte
Transaction Gateway address space APPLID names found in the
SMF type 111 records. The user-selected values are stored in
data element CICS Transaction Gateway ID (CTGID).
The GATEWAY ACTIVE and GATEWAY APPLID statements are
discussed in detail below.
GATEWAY ACTIVE
--------------
To initiate processing of the SMF type 111 interval records
generated by z/OS-based CICS Transaction Gateway address
spaces, a GATEWAY ACTIVE statement must be added to CICOPS.
The GATEWAY ACTIVE statement has the following format:
GATEWAY ACTIVE
There are no additional arguments.
The addition of a GATEWAY ACTIVE statement and execution of
prefix.MICS.PARMS(CICPGEN) results in the following:
o Step DAY040 in the DAILY update job will accept and
process SMF type 111 records.
o SMF type 111 records generated by CICS Transaction
Gateway address spaces whose APPLID name is recognized
(via GATEWAY APPLID statements) will yield CA MICS
Gateway Server Activity (CTGGSA) file observations.
o Where the APPLID name is not recognized, records will by
rejected, but the DAY040 step MICSLOG will generate
CIC07081W warning messages as shown below:
CIC07081W Rejected CICS Transaction Gateway data
CIC07081W APPLIDs not defined in CICOPS
CIC07081W
CIC07081W ORGSYSID APPLID RECORD COUNT
CIC07081W ---- -------- ------------
CIC07082W SYS1 CTGAPPL1 96
CIC07082W SYS1 CTGAPPL2 96
CIC07082W SYS2 CTGAPPLX 96
Note: Specifying a GATEWAY ACTIVE statement without any
accompanying GATEWAY APPLID statements is a convenient way to
determine the CICS Transaction Gateway APPLID names at your
site. The CIC07081W message data can be used to construct
GATEWAY APPLID statements for those APPLIDs you want to
process.
Because these records are rejected, there is no check to see
if your prefix.MICS.PARMS(SYSID) or
sharedprefix.MICS.PARMS(CPLXSID) members have ORGSYSID
entries associated with the undefined APPLIDs. If you add
GATEWAY APPLID statements for any of these APPLIDs, make sure
that your SYSID member has entries for the associated
ORGSYSIDs.
GATEWAY APPLID
--------------
GATEWAY APPLID statements associate a four-byte user-assigned
transaction Gateway ID value, with the eight-byte Transaction
Gateway APPLID.
The user-assigned four-byte value is used for CA MICS
checkpoint processing. It is also stored in data element CICS
Transaction Gateway ID (CTGID), which serves as the second-
level sort summarization key (after SYSID) in the Gateway
Server Activity (CTGGSA) file.
The GATEWAY APPLID statement has the following format:
GATEWAY APPLID applid ctgid
Note: The parameters are positional and are separated by one
or more blanks.
where:
applid = Application identifier for the CICS Transaction
Gateway address space. The best way to identify the
APPLID values at your site is to add a GATEWAY
ACTIVE statement to CICOPS, execute
prefix.MICS.CNTL(CICPGEN), then run a DAY040 daily
update step with SMF type 111 records in the SMF
data input.
The DAY040 step MICSLOG will contain CIC07081W
messages that specify all Gateway APPLID values
encountered and the z/OS system where they were
found.
ctgid = One- to four-byte CICS Transaction Gateway
identifier that you assign to identify a Gateway
address space to CA MICS. The CTGID must start
with a letter. It may contain letters, digits, and
underscores. Other special characters are not
allowed.
CA MICS combines CTGID and ORGSYSID (SMF system ID)
to uniquely identify Gateway APPLIDs. Two Gateways
executing on two different systems may have the same
APPLID, because the combination of ORGSYSID and
CTGID would be unique. (The SMF systems are
different.) Two Gateways running on the same system
must have different APPLIDs to ensure the uniqueness
of the ORGSYSID/CTGID combination.
Note: The value chosen for CTGID cannot be the same
as a value chosen for CICSID in a CICOPTS statement.
The maximum number of system, subsystem, and
combined entries cannot exceed the limit of the
prefix.MICS.CHECKPT.DATA data set. The default
maximum number of entries is 100. This number is
adequate for most data centers; however you can
reconfigure a unit's checkpoint size to allow a
maximum of 1000 entries.
For further discussion of the checkpoint file size
and changing the default, see Section 2.3.2.4 of the
PIOM, Site Characteristics (SITE).
Example:
Sample GATEWAY ACTIVE and GATEWAY APPLID statements are shown
below:
GATEWAY ACTIVE
GATEWAY APPLID TGWYPRD1 GWP1
GATEWAY APPLID TGWYPRD1 GWP2
GATEWAY APPLID TGWYTST1 GWT1
Refer to the checklist in section 10.1.18 for the steps
required to process CTG SMF type 111 records.
