IEC161I (return code 001)
rc[(sfi)]-ccc,jjj,sss,ddname,dev,volser,xxx,dsname, cat

Explanation

General Information for Message IEC161I:

An error occurred during the processing of an OPEN macro instruction for a VSAM data set. The return code and system actions documented in the following text also apply to the CLOSE and EOV messages IEC251I (CLOSE), IEC252I (CLOSE TYPE=T), and IEC070I (END OF VOLUME).
Note: IEC161I is issued by Media Manager if problems are encountered during CONNECT, CATALOG READ, or CATALOG UPDATE processing.

In the message text:

rc
The return code. This field indicates the reason for the error. For the meaning of a return code and the corresponding system actions and operator and programmer responses, see "Specific Information for This Return Code" in the IEC161I message description for the return code.
sfi
Subfunction information (error information returned by another subsystem or component). This field appears only for certain return codes, and its format is shown with those codes to which it applies.
ccc
The problem determination function (PDF) code. The PDF code is used only by the IBM Support Center if further problem determination is required. If the PDF code has meaning for the user, it is documented with the corresponding return code.
jjj
The job name.
sss
The step name. This field might contain the name of the procedure step followed by the name of the job step that called the procedure. No comma separates the two names:
  • If the step is part of a procedure, the eight-character name of the procedure step, including trailing blanks
  • The step name, without trailing blanks
ddname
The data definition (DD) name.
dev
The device number, if the error is related to a specific device.
volser
The volume serial number, if the error is related to a specific volume.
xxx
The name of the cluster that contains the data set being processed when the error was detected. When the cluster name is not available, this field contains the DSNAME value specified in the DD statement indicated in the access method control block (ACB).
dsname
The name of the data set being processed when the error was detected.
cat
The catalog name.

Any missing field is indicated by a comma.

If xxx specifies AMASTCAT, the error involved the master catalog. If the master catalog failed to open successfully, the cause of the failure must be corrected and the system restarted (re-IPL).

Specific Information for This Return Code:

System-managed buffering (SMB) was requested. If any subfunction information was returned, it indicates that:
  1. An error occurred during VSAM system-managed buffering processing with the direct optimized (DO) technique. Either SMB proceeded with a different access bias (direct weighted), or normal VSAM processing took over and SMB was not used.
    The (sfi) field in the message is in the form of (rc,rsn). It contains the return code and reason code for the error. The (sfi) field might represent a message from either one of the following sources:
    • The BLDVRP function when SMB is building an LSR pool.
      For BLDVRP information message text:
      rc
      The BLDVRP return code, a decimal value.
      rsn
      The BLDVRP reason code, a decimal value.
    • SMB processing.
      For SMB information message text:
      rc
      Is one of the following return codes:
      • 101: The user did not specify enough virtual storage for direct optimized (DO) when using the SMBVSP parameter. Direct weighted (DW) was used instead.
      • 102: During direct optimized (DO) processing, the first try for an optimum amount of storage failed. The optimum amount, however, was already less than the defined minimum, so SMB defaulted to using the direct weighted (DW) technique.
      rsn
      The reason code is set to 0 when accompanied by SMB return code 101 or 102.
  2. If ccc=255, user requests informational message regarding the actual access bias being chosen by SMB by specifying JCL AMP MSG=SMBBIAS. The system issues two IEC161I (return code 001) messages.
    The first IEC161I (return code 001) message indicates the access bias used by SMB. The sfi field can be:
    • DO – Direct Optimized
    • DW – Direct Weighted
    • SO – Sequential Optimized
    • SW – Sequential Weighted
    • CO – Create optimized
    • CR – Create Recovery
    • Start of change?? - OPEN could not determine the bias typeEnd of change

    The second IEC161(return code 001) message that follows contains the SFI information in the form of four hexadecimal numbers:

    IEC161I 001(AAAAAAAA BBBBBBBB CCCCCCCC DDDDDDDD)-255.

    In the message text:
    AAAAAAAA
    Hexadecimal value of the number of buffers selected for base data component.
    BBBBBBBB
    Hexadecimal value of the number of buffers selected for base index component.
    CCCCCCCC
    Either an hexadecimal value of the number of buffers selected for PATH data component or zero if no path.
    DDDDDDDD
    Either an hexadecimal value of the number of buffers selected for PATH index component or zero if no path.
    Note: It is suggested that this message is for diagnostic or informational purpose only. VSAM OPEN will issue the message for every component being opened using this DD statement. It might flood the console during normal processing.

    For more information on SMB and its access bias, see z/OS DFSMS Using Data Sets.

System action

OPEN processing continues for the data set. The error flag (ACBERFLG) in the ACB (access method block) for the data set is set to 0 (X'00').

Operator response

None

System programmer response

If subfunction information is present and the ccc code is not 255, review the return code in the message (sfi) field to determine why the requested system-managed buffering could not be provided. Correct the condition and run the job again.

Programmer response

See System Programmer Response.

Source

DFSMSdfp

Module

IDA0192J

Parent topic: IEC messages