Creating server options by using the ISPF interface
You can create and edit the server options as follows:
- Select Server options from the Main Menu.
- On the Server Options Entry panel, follow these steps and press Enter:
- In the Options library field, enter the name of the load library where the server options are to be maintained.
In the Server ID field, enter the four-character server ID that corresponds to the parameter in the server JCL.
File Options Help
-------------------------------------------------------------------------------
BMC AMI Datastream for IMS Server Options Entry
Command ===> _________________________________________________________________
Specify Options information.
Options library . . . . . 'BMC.AFI.OPTIONS'
Server ID . . . . . . . . SEV3 (blank for selection list)
F1=Help F3=Exit F12=CancelIn the Edit Server Options panel, edit the options by using the following guidelines.
File Edit Options Help
-------------------------------------------------------------------------------
Datastream for IMS Edit Server Options Row 1 to 3 of 3
Command ===> ________________________________________________ Scroll ===> PAGE
Server ID . . . . . . . . . : SEV3
Extract list library . . . . 'BMC.AFI.EXTRACT'
Number of buffers . . . . . . 4096 (4096-999999)
Other options. Select if wanted.
/ Send records to BMC AMI z/OS subsystem CZAI
Sources. Enter one or more action codes. S=Edit D=Delete I=Insert R=Repeat
Source Extract Dest
A Source Type List Fmt Type Destination
_ -------- -------- -------- ---- -------- -----------------------------------
_ IMSA IMS EXTLST01 JSON TCP/IP XY-BMC-SERVE007:12345
_ IMSCONN IMSCONN EXTLST02 CSV DATASET 'BMC.AFI.IMSCONN.OUT'
_ IMSB IMS EXTLST03 CSV DATASET 'BMC.AFI.IMS.OUT'
******************************* Bottom of data ********************************
- The server ID is populated automatically. A server can handle multiple IMS control regions and IMS Connects.
- Enter the extract list library that contains the extract lists that the server will use to select data.
- Specify the number of intermediate buffers to use to process and filter the data elements. We recommend a value of 4096.
To add an IMS or IMS Connect as a source from which data will be extracted, enter I in the A (action) column.
The Edit Source/Destination for Server panel is displayed as follows:Edit Source/Destination for Server SBAF
Command ===> _________________________________________________________________
Source. Specify the source of the data to extract.
1 1. Connect to IMSID . . . IMSA
2. Connect to IMS Connect ________
Extract list. Specify the member containing extract information.
Extract list . . . . . . EXTLST01
Output format. Specify the format of the extracted output.
2 1. JSON
2. CSV
Headings. Select the CSV heading rows to output, if any.
/ Field names row _ Field types row
Destination. Specify where to route extracted output.
2 1. TCP/IP
IP address (host:port)
2. Data set
Output data set name 'BMC.AFI.IMS.OUT'
Existing GDG? . . . . N (Y or N)
Allocation information.
SMS Management class ________ (For SMS managed data set)
SMS Storage class ________ (For SMS managed data set)
Volume serial . . . ______
Generic unit . . . . ________
Space units . . . . CYLINDER (TRKS or CYLS)
Primary quantity . . 1 (in above units)
Secondary quantity 1 (in above units)
F1=Help F3=Exit F7=Up F8=Down F12=Cancel- On the Edit Source/Destination for Server SBAF panel, follow these steps:
a. In the Source field, specify whether the server should obtain data from IMS or IMS Connect. Specify the appropriate ID of the source: either the IMSID for IMS or the started task name of the IMS Connect.
b. In the Output format field, select the format of the extracted output. Valid values are JSON and CSV.
If you selected CSV, select the heading row to output. You can select both the field name and its field type or only the field name.
Some log records contain tabular data with multiple entries under the same heading. When these log records are written in CSV format, multiple rows are generated for a single log record. Any process that reads or analyzes the CSV file must be designed to handle these additional rows.
BMC AMI Ops for IMS writes FA log records that include a variable number of trailer segment. Each trailer segment represents a database accessed by an IMS transaction. For more information, see Description of the DBD variable segment of the transaction log record.
- In the Extract List field, enter the extract list that the server will use to select data.
- Select the destination type as follows:
- If you select 1. TCP/IP, the data items are sent directly to the named destination specified in the IP Address.
If you select 2. Data set, the data items are sent to the data set specified in the Output data set name. If the output data set name already exists, it is overwritten. Otherwise, it is allocated according to the allocation information specified.
In this field, specify the name of a sequential data set that is used to save the extracted output. The required space depends on the number of records and fields extracted. The data set can be either an existing GDG base or a new PS. You can use the symbolic keywords %SID, %AFDATE, %AFTIME, and %N in the data set name.
BMC AMI Datastream for IMS replaces these keywords as follows:
Keyword Replacement %SID Four-character server ID %AFDATE Current date in YYYYDDD format %AFTIME Current time in HHMMSST format %N 00–99 incrementally if the previous data set name is the same as the current. - If the output data set name is not a GDG, you must specify GDG=N. If the output data set name is a GDG, you must specify GDG=Y.
- If a GDG is to be used, define the GDG base. Use a batch IDCAMS job or the following command on a separate ISPF panel, Option 6:
DEFINE GDG(NAME(‘your.gdg.base’) LIMIT(##) SCRATCH))
where ‘your.gdg.base’ is the name of the GDG base to be used, and ## is the number of generations to maintain.
- Press F3 to to return to the Edit Server Options panel.
- Repeat steps 4 to 7 to add additional sources or destinations.
- Press F3 to save the changes and exit.