CA MAX IMS/UTIL FAQ's

Document ID : KB000055136
Last Modified Date : 14/02/2018
Show Technical Document Details

What software delivery options are available?

The recommended method is to electronically download the software and documentation from CA's Support website - http://support.ca.com or you can choose to install the MAX software libraries via a cartridge tape which can be shipped to you.

What are my options for applying PTFs?

We provide replacement objects when maintenance is required. These can be obtained by downloading the current maintenance from CA Support website - http://support.ca.com. Since our maintenance is cumulative, you can download the latest version from http://support.ca.com then install the .OBJECT library to apply all current maintenance. For additional information please visit the Support By Product home page for the CA MAX products on http://support.ca.com.

What are the COPYBOOK LIMITS when using formatted functions?

If you encounter limitations in our copybook support, we suggest an upgrade to the current release. There used to be limitations related to the OCCURS DEPENDING value, but these have been eliminated.

What is the Installation Verification Program (IVP)?

The Installation Verification Program is used for troubleshooting a new installation, or verifying what maintenance has been applied. It can be invoked using the "TSO MAX IVP" command. In the event you have a problem, we may ask you to email the output from this command. This command can also be used to verify that product code installation was successful.

I received an IRX0251E User abend code 0688 when I try and view an IMS DB?

Any IMS abend code is a code returned by IMS (as opposed to an error issued by CA MAX IMS/UTIL). These can all be looked up in the IMS "Messages and Codes" manual (V7 is GC26-9433/vol1 and GC27-1120/vol2. IMS V8 is GC27-1301/vol1 and GC27-1302/vol2.)

In this particular case, the IMS control region specified is either not up, or incorrect.

I received a MAX181E when trying to use the TRANSLATE function.

The TRANSLATE function can use one of several pre-defined translate tables. These are found in the MAXDFLTS member. While it is normally optional to assemble the MAXDFLTS module, it is required if you intend to make use of these tables or if you wish to define your own.

Can I display COPYBOOK with field name, offset and length information?

Yes, in IMS/Util you can display this copybook information by selecting menu item "3. IMS utilities", then choosing "B. copyBook display/print".

For the BATCH equivalent, you would use the "PRINT COPYBOOK(pds.name(member))" function.

Can I access COPYBOOKS in PANVALET or LIBRARIAN libraries?

Yes. When accessing a copybook in a PANVALET or LIBRARIAN library, you must define the subsystem used for file access. In TSO this is done by selecting "0. Profile parameters " from the main menu then supply the subsystem name. In BATCH, you use the SUBSYS parameter in your control statement.

How do I define MAPPING CRITERIA?

To define Mapping Criteria for an IMS database, you should have all the copybooks used to define the database (usually, but not always, one for each segment name). Then, on the main menu of IMS/Util, select option "7. build Mapping criteria". The confirm window should have the name of the MAPPING member you are defining or updating, not the name of your copybook(s). Then, when you choose "1 - Insert layout" you describe the copybook that you will use to map the data. A single mapping entry can provide multiple mappings, based on the data within a segment. The view can customize the file display by selecting only certain records, based on selection criteria, and selecting only certain fields to be displayed. Repeat this for each segment/copybook required for your formatted displays. Use the description field to detail what each mapping view was intended for.

NOTE* The SELect in mapping criteria isn't the same as the SELect in BROWSE or EDIT modes.

When you SELect segments you are looking at a subset of the file, while the SELect in MAPPING isn't selecting segments, it's selecting the COPYBOOK to be used based on data within the segment.

What are Data Privacy (HIPAA) functions?

The data privacy operands are PIN, SCRAMBLE, UNSCRAMBLE and TRANSLATE. These features allow masking sensitive data, while preserving data formats for testing. Production files can be input to building a test bed, where the resulting test files contain no sensitive data.

What are Data Transformation functions?

The Data Transformation functions allow reformat of mainframe data (MVS formatted, IMS and DB2) to XML, comma delimited, tab delimited and other formats. User specified formats may be created, as specified in an assembler macro.

Do you support Dynamic PSBs?

Yes. The IMS/Utility, both Batch and Online components, now support Dynamic PSB generation. Static PSBs are still supported, and you can specify for which systems you allow dynamic PSB support.

Can I get a more detailed error message?

Press PF1 for extended text version of any error message.

Can I locate records containing INVALID PACKED DATA?

You can use the 'FIND NEP' (not-equal packed) command. You define the field and the Browse or Edit function (unformatted) will stop at each record where invalid data is found. If position 38 is supposed to be the start of a packed data field, just enter "FIND NEP 38" and the scan will stop at each invalid record.

In BATCH, you can also use the NEP function to list all records not containing a valid packed. You can also validate that the field contains packed data of a specified length.

What REGION SIZE do I need for MAXIBAT?

The REGION size requirement is variable, depending on the number of parameters and the complexity of the function performed, but we recommend a 4M region for most MAXIBAT executions.

When do I specify single quote 'vs. double quote"

There is support for multiple search arguments in a Batch control statements. Comma delimited arguments within single quotes are treated as multiple arguments, while the same string within double quotes is considered a single argument.

What is the 'dupl' sub operand for?

There is support for a duplication factor when defining strings.

How can I perform a CASE SENSITIVE search using IMS/UTIL Batch? I want to select records containing lower case 'string', but I don't want to see select those with upper case 'STRING'. How do I define a case sensitive search argument?

This is controlled by the type of data you define. Use the Text search when you want case insensitive, and Character when you want the case to match:

T'string'

The above string is NOT case sensitive. String selected regardless of case.

C'string'

The above string IS case sensitive. Only exact match will be selected.

How can I perform a CASE SENSITIVE search using IMS/UTIL Online? I want to select records containing lower case 'string', but I don't want to see select those with upper case 'STRING'. How do I define a case sensitive search argument?

This is controlled by the type of data you define. Use the Text search when you want case insensitive, and Character when you want the case to match: In 'unformatted' mode, use the FIND command where:

FIND argument is NOT case sensitive

FIND 'argument' IS case sensitive

In 'formatted' mode, the SEL command is an exact match only - if you need case insensitive select, use the FIND command.

What data types can I define in a batch job?

When entering data strings, whether for selection criteria or for use in batch control statements, the following can be defined:

X'hexstr'        Hex chars
P'nnnnnn'        Packed signed 
U'nnnnnn'        Packed unsigned 
Z'nnnnnn'        Zoned - signed 
N'nnnnnn'        Zoned - no sign
C'xxxxxx'        Case Sensitive
T'xxxxxx'        Case Insensitive 

Where can I place COMMENTS in batch control statements?

When a , (comma) is encountered outside parenthesis or quotes the rest of the statement is ignored.

In addition to marking the end of a statement, a comma indicates the statement is continued. If you want to add a comment to a statement that is not continued, use ; (semicolon) instead. You can also begin a statement with an "*" and the entire statement becomes a comment.

What is the difference between CHANGE, REPLACE and EDIT?

The CHANGE operand will shift the remainder of the record left or right when the from and to strings are different lengths. The data to the right of the found to string will shift left or right to accommodate the extra/missing bytes. If a variable length record, the record length will be adjusted accordingly (when the O/P file RECFM or LRECL permit).

The REPLACE is used to OVERLAY data, so use it carefully. If you use the replace function and the from-data string is 3 characters, and the to-data string is 4 characters, you will wipe out one byte following the from-data.

The EDIT is used to change data in a text type record. If the length of the to-data is greater than the from-data length, repeating space characters will be used to accommodate the difference. If the length of the to-data is less than then from-data length, additional bytes will be inserted after the first space character to the right of the from-data.

Here are some examples where we change the string MY.TEST.LOADLIB to the string MY.NEW.REPLACED.LOADLIB. We also have a comment that begins in col 55 and ends in col 71:

    0    1    1    2    2    3    3    4    4    5    5    6    6    7    7
....5....0....5....0....5....0....5....0....5....0....5....0....5....0....5
Original record:
//STEPLIB DD DSN=MY.TEST.LOADLIB,DISP=SHR       A comment
//STEPLIB DD DSN=MY.NEW.REPLACED.LOADLIB,DISP=SHR      A comment    (1)
//STEPLIB DD DSN=MY.NEW.REPLACED.LOADLIBR       A comment           (2)
//STEPLIB DD DSN=MY.NEW.REPLACED.LOADLIB,DISP=SHR      A comment    (3) 

In (1), we used a CHANGE. The number of spaces between SHR and A comment did not change.

In (2), we used REPLACE. Because the to-data was longer than the from-data, we overlaid the ",DISP=SH" that followed the from-data.

In (3), we used EDIT. The additional length of the to-data was taken up by the spaces between the SHR and A comment.

Why are menu items A and M identical on the Dataset Utilities Screen?

This is depends on your OS/390 or z/OS release. On older systems there were separate screens for the allocation of SMS controlled datasets (M) and other datasets (A). On newer MVS releases, these have been consolidated but users of older systems will have two different displays.