IMS Print

Use the IMS Print utility function to print data from either all segments in an IMS database, or only those segments selected by the view you specify.

You can choose to print the segments in Character or Hex format, or, if a view is specified, in Character, Hex, Single, or Table format.

If the print completes successfully, the output will be displayed in an Eclipse editor.

This page details the mapping of fields to batch parameters and miscellaneous notes. Refer to the IBM File Manager® Users Guide and Reference for IMS for further information.

Basic Settings

Subsystem - you can specify the IMS subsystem using the lookup button on the right. From here, you can also edit the subsystem's configuration by clicking on the edit button to the right of the field.

Region Type - Specifies the region type that you want the function to run in. The database must be online to use BMP, and you can use DLI when the database is offline or if there is data sharing support. Either of these options may be disabled by your system administrator in the File Manager installation options. Batch parameter: REGNTYPE

Mode - Specifies whether to use an existing PCB in a PSB to specify the segments to print (static), or whether File Manager for z/OS should dynamically create a PCB for the entered database (dynamic). Either of these options may be disabled by your system administrator in the File Manager installation options. Batch parameter: PSBTYPE

Use view - If you would like to use a view, specify the name of the data set that contains the view that you want the print to use; if it is a PDS or Library data set, a member must also be specified. Batch parameter names: VIEW, VIEWDSN

Print format - Specify the print format to use for the print. Character will print one set of segments per line, Hex will print one set of segments over 3 lines so that the last 2 lines are the hex equivalents, Single will use the specified view to format each set of segments so that each field is on a new line, and Table will print each set of segments on their own line but with the fields specified in the view used as columns for a tabular format. Batch parameters: PRTFORM

Back to top

Processing options

Keys range - If you would like to restrict the print to segments with a certain range of key values, specify the key value range here. You must specify a start and end key, separated by a comma. You may use hex escaping (e.g. X'4040') or case escaping (e.g. C'Aa') individually for each key, and you must use one of these for any key values which contain a comma. Batch parameter: KEYRANGE

Keys list - If you would like to restrict the print to segments with a certain set of key values, specify the set of keys here. If you specify more than one key value, separate each key value from the next by using a comma. You may use hex escaping (e.g. X'4040') or case escaping (e.g. C'Aa') individually for each key, and you must use one of these for any key values which contain a comma. Batch parameter: KEYLIST

Keys file - If you would like to restrict the print to segments with a certain set of key values, and you have a data set or member which contains the key values of the root segments of the records that you want printed, specify the name of that data set (and optionally member) here. Batch parameter: KEYEXT, batch DD: KEYSFILE

Maximum root segments - If you would like to limit your extract to a certain maximum number of segments, enter that maximum here. Batch parameter: MAXROOTS

Edit Database Data Sets - If Mode is set to Dynamic, you may tick this box to edit the database data sets for the entered database name prior to running the print. If ticked, a separate dialog will be shown to allow you to edit these; changes you make will be persisted for the database and subsystem which you make them for. This option will have no effect if the system administrator has configured the selected IMS subsystem's installation options to use dynamic allocation of data sets, or if the entered database is a HALDB. Batch parameters: DBDDSN1, DBDDSN2, ..., DBDDSN6

Interaction between processing options: - The final set of segments to print is the set of all segments which key range, key list, and keys file would cover together (union, i.e. added together with duplicates removed).

Back to top