Modify initialization parameter cards to match the resources you have configured for the Ironstream client configuration. The parameter card dataset member(s) are pointed to by the SYSIN DD of the started task.
The Ironstream parameter cards are located in:
hlq.SAMP(DDMPARM)
Parameter cards may contain system symbols to ensure uniqueness if the same dataset member is being used for multiple LPARs. Symbols must start with an ampersand (&) and must end with a period if the symbol substitution occurs in the middle of a string. For example, to incorporate the value of &SYSNAME. into the name of the console defined for the CMD subtask, the parameter card would look like:
CMD &SYSNAME.CON
A detailed description of the parameter cards follows.
CMD Parameter Card
Provides Ironstream with the ability to issue z/OS (MVS) commands.
Valid Values
consname [LOG|NOLOG] [HC={YES|NO}]
Sample Syntax
CMD EVOCONS2 NOLOG HC=YES
Description
This card will initialize the CMD subtask, which is used to send z/OS (MVS) commands from Ironstream to the mainframe OS.
Parameters
|
DELAY Parameter Card
Number of seconds to wait until the next attempt to restart a subtask.
Valid Values
1 to 86400 (seconds)
Sample Syntax
DELAY 45
Description
Specifies the amount of time (in seconds) before a subtask attempts
restarting itself following a termination. The maximum delay time
allowed is 86,400 seconds (one day). Each subtask parameter card can be
coded with its own unique delay time. Customize any subtask by entering
in the desired DELAY card immediately before the
subtask card. Any DELAY value entered becomes the default for all
subsequent subtask cards.
The delay time reflects how quickly a needed resource can be recovered. A TCP subtask may require time to reset the port through which the workstation is connected. The default DELAY value is 30 seconds.
FILTER Parameter Card
Identifies the z/OS commands that may be issued to the mainframe agent.
Valid Parameters
CMD regexpression
Sample Syntax
FILTER CMD ^D
TCPIP,.*,NETSTAT,ROUTE$
FILTER CMD ^D
NET,MAJNODES$
Description
Use this card to identify z/OS (MVS) commands that may be issued through the Ironstream extended console (initialized by the CMD parameter card above). Specify only one command expression per FILTER CMD line. If a command is issued which has no match in the command filter table, an EVO161 message will be returned to inform the caller that the command is unauthorized.
Parameters
|
NLS Parameter Card
Set the National Language Support (NLS) codeset value.
Valid Parameters
[CODESET=value] [LANG=langcode]
Sample Syntax
NLS CODESET=IBM-1047
NLS CODESET=IBM-939
LANG=JPN
Description
This card is used to identify the character set used on the mainframe
and language used for supported message translations. The
value must be a codeset provided by the z/OS
Language Environment. A list of codeset values is provided in Appendix D
of the IBM C/C++ Programming Guide (IBM publication SC09-4765).
The langcode must be a supported language code
that is available on this mainframe.
Parameters
|
OSINFO Parameter Card
Initializes the OSI subtask to respond to various requests for z/OS Operating System information and statistics.
Valid Parameters
[SDSFMAX=s]
[BYTESMAX=b][CPCONV={cp,old,new}[,...]]
[(q)]
Sample Syntax
OSINFO BYTESMAX=120000 CPCONV=IBM-1146,5B,4A,*,4A,4B4B
(20000)
Description
Use the OSINFO card to initialize a subtask which will accept command
type 46 requests from the Ironstream client and perform the requested
function. See the Ironstream Administration Guide for syntax of
type 46 requests and the available options. The //ISFIN
and //ISFOUT DD names must be present in the agent's
JCL to use the SDSF requests. These are normally defined as temporary
datasets.
Parameters
|
PRINTCARDS Parameter Card
Write the SYSIN cards to the SYSPRINT.
Valid Values
None
Sample Syntax
PRINTCARDS
Description
The PRINTCARDS card instructs the VP390 job to print each of the SYSIN lines that it reads to the SYSPRINT, excluding blank lines and comment lines. This is usually only used to document the cards that have been read when sending the SYSPRINT output to support for problem analysis. Enter PRINTCARDS as the first line of the SYSIN dataset member to document all the lines of the SYSIN input.
The PRINTCARDS card can be used multiple times in the SYSIN as a toggle control. The second occurrence of PRINTCARDS will stop the writing to SYSPRINT, the third occurrence will resume the writing, and so forth.
Parameters
None
MQMODEL, MQCOMMAND and MQDYNAMIC Parameter Cards
Overrides to the default MQ Series queue names
Valid Values
Valid MQ Series queue names (up to 48 characters)
Sample Syntax
MQMODEL EVIEW.COMMAND.REPLY.MODEL
MQCOMMAND EVIEW.COMMAND.INPUT
MQDYNAMIC EVIEW.COMMAND.REPLY.Q
Description
These three parameter cards define overrides to the default MQ queue names when sending a command to the MQ Series. (See "Using OSINFO System Information API Commands" option 50 on page 24 of the Administrator's Reference.) The default queue names are:
|
If any of these default names are changed, the associated RACF permission must be changed to match the new names. (See "WebSphere MQ" on page 35.)
If used, these MQ parameter cards must be placed in the SYSIN deck ahead of the OSINFO card.
Parameters
None
RESTART Parameter Card
Number of restart attempts to allow a subtask before giving up.
Valid Values
1 to 65535, or UNLIMITED
Sample Syntax
RESTART 100 RESTART UNLIMITED
Description
Specifies the number of times a subtask attempts to automatically restart. After this limit is reached, the subtask remains in a "down" state until it is manually reactivated using the INIT command. (See the description of the INIT command in Appendix A of the Ironstream Administation Guide.) Specify UNLIMITED instead of a number to allow a subtask to make an unlimited number of restart attempts. Each subtask can have a unique restart count by specifying another RESTART card immediately before the card which defines the subtask. The default RESTART value is 5.
SMF Parameter Card
Initializes the SMF subtask to send SMF data to the ServiceNow server at specific intervals.
INTERVAL=n
REC={TYPE|NOTYPE}(type[(subtype[:subtype2][,subtype]...)]
[:type2][,type]... )
Sample Syntax
One card:
SMF INTERVAL=30 REC=TYPE(30(4:5))
or multiple cards:
SMF INTERVAL=8 REC=TYPE(14:15,25)
SMF REC=TYPE(30(1,3:5))
SMF REC=TYPE(40,80,83)
where the INTERVAL parameter is required only on the
first line.
Description
The SMF card initializes a subtask which will install SMF exits to collect SMF record data and poll for the collected data on the specified interval and send the SMF data to the ServiceNow MID server. The Discovery processes requires SMF Type 30 records of subtype 4 and 5 if mainframe job and program probes are active.
Specifying the SMF records on this card follows the same syntax rules as the “REC=” option in the SMFPRMxx member of SYS1.PARMLIB.
Parameters
|
SMFDATASPACE Parameter Card
Size of the dataspace buffer to hold incoming SMF records.
Valid Values
32768 to 2147483647
Sample Syntax
SMFDATASPACE 20000000
Description
The SMFDATASPACE card specifies the size (in bytes) of the dataspace that will be used as a buffer to hold SMF records retrieved by the SMF exit programs. The default size is 20 megabytes. If an invalid value is specified, an EVO008 error message will be written to the joblog, and the default size will be used.
TCP Parameter Card
Identify port numbers and parameters for the TCP/IP connection to the Ironstream client.
Valid Values
mmsport cmdport [hlq]
[BUFDD=dd1,dd2 [ACK=ack] [LIMIT=limit]]
[HB=hb] [BINDIP=bindaddr]
[SERVERIP=servaddr[/{maskaddr|maskprefix}]]
[TLS=Y|N|V] [KEYF=filename1]
[STAF=filename2]
Sample Syntax
TCP 6106 6107 BUFDD=BFR1,BFR2 ACK=5 LIMIT=20 HB=30
BINDIP=10.1.1.8 SERVERIP=10.1.1.0/24
Description
This card will initialize a TCP subtask, which is
responsible for opening two TCP/IP ports on the mainframe, then waiting
for an Ironstream client component to start communication with the
mainframe agent via these ports. While it waits for a connection, the
TCP subtask can optionally write new mainframe
messages to a set of buffering files, and then send the buffered
messages after a connection is established. If you are also using the
same Ironstream job for Discovery and Operations Management, you will
need to define two TCP parameter cards. The
mmsport and cmdport
parameters must be unique for each TCP card defined. TLS encryption
between the agent and the server is available. The additional steps for
setting up TLS encryption are given in Appendix B.
Parameters
|
TSOUTPUT Parameter Card
Name a dataset for the capture of NETSTAT output.
Valid values
A valid name for a pre-allocated z/OS dataset - the Discovery agent must have read and write access to this dataset.
Sample Syntax
TSOUTPUT SYS3.DISCOVER.NETSTAT
Description
This optional parameter allows you to name a dataset to be used for
capturing NETSTAT output. This is used by the OSINFO type 46 commands
with options 110 through 114. If you do not provide it here, you must
ensure there is a //TSOUTPUT DD statement in the agent
JCL pointing to a dataset.
The dataset must be pre-allocated and have attributes of:
DSORG=PS,RECFM=VB,LRECL=1028,BLKSIZE=6144,SPACE=(TRK,(1,1))