bdfu1m1fUtilities

ZUDFM OAI-File Access Using the ID or DSECT Name

Use this command to link to a subfile when you know the file ID or the DSECT name of the file. This command also displays information about the file to which you are linking.

Requirements and Restrictions

None.

Format




Note:
You can use either the ZUDFM OAI or the ZUDFM ACCESS command.

filespec
is the file specification, which can be a 2-character or 4-hexadecimal file ID, or the DSECT name (up to 6 characters).

ALG-
specifies an argument that is used to determine the subfile to be linked.

algarg
is the algorithm argument, which is entered according to the syntax required by the algorithm for this file structure. It uses the algorithm defined in the file DSECT macro definition (in global symbol &SW00RBV). The length of the algorithm argument is taken from the database definition (DBDEF). See TPFDF Database Administration for more information about algorithm arguments.
Note:
This variable can contain a mixture of hexadecimal and character data. To switch between these types of data, use the vertical bar (|) as a delimiter. The following example shows how the types of data can be mixed:
     8013B4|THIS IS CHARACTER DATA|4A5F90

The TPFDF product that assumes the variable starts with hexadecimal data. To start with character data, place a vertical bar at the beginning of the variable. For example:

     |STARTING WITH CHARACTER DATA|1F2E3D4E

You can use a different delimiter by setting variable #DBENUFB in the ACPDBE macro. See TPFDF Installation and Customization for more information about the ACPDBE macro.

ORDC
specifies the ordinal number in decimal format.

ORDX
specifies the ordinal number in hexadecimal format.

ordnum
is the relative record ordinal number of the prime block of the subfile to which you want to link between the beginning ordinal (BOR) and end ordinal (EOR), inclusively. It will be mapped to the appropriate FACE ordinal based on the partition and interleave entered.

PARTITN
specifies a partition (a file where the prime blocks are grouped together into different partitions).

PTN
an abbreviation of the PARTITN parameter that can be used interchangeably with it.

partn
is a partition number that starts at 0. The TPFDF product locates the prime block, and any pool blocks chained to it, at the specified position and links to them.

INTERLV
specifies an interleave (a file where the prime blocks are grouped together into different groups).

ILV
an abbreviation of the INTERLV parameter that can be used interchangeably with it.

interlv
is an interleave number that starts at 0. The TPFDF product locates the prime block, and any pool blocks chained to it, at the specified position and links to them.

CREATE
is used to create an empty pool file, which is not indexed, with the specified DSECT name or file ID of the subfile. You can also create a new indexed subfile by using a CREATE and ALG- parameter together.

PATH
specifies the path value of the index that you specify with the ALG- parameter. The path value is an integer. If you omit it, the command assumes a path of zero.

pathnum
is a numerical path value as defined in the database definition (DBDEF) table.

RELEASE
removes all index LRECs from all index levels. The pool file is not returned to the TPF or ALCS system using the TPF or ALCS RELFC macro.

Additional Information

Examples

The following shows an example of linking to a file using the specified file ID.

+--------------------------------------------------------------------------------+
|User:   ZUDFM OAI/FDE9                                                          |
|                                                                                |
|System: UDFM0301I          FILE INFORMATION DISPLAY                             |
|        FILE IDENTIFIER               FDE9                                      |
|        FILE ADDRESS                            X F402E004                      |
|        FACE RECORD TYPE            D 00000190  X 000000BE                      |
|        FACE START ORDINAL          D 00000001  X 00000001                      |
|        FACE END ORDINAL            D 00000001  X 00000001                      |
|        CURRENT FACE ORDINAL        D 00000001  X 00000001                      |
|        CURRENT RELATIVE ORDINAL    D 00000000  X 00000000                      |
|        TPFDF ALGORITHM             D 00000004  X 00000004                      |
|        INITIAL NAB VALUE           D 00000026  X 0000001A                      |
|        TPFDF END ORDINAL           D 00000001  X 00000001                      |
|        VARIABLE LOGICAL RECORDSIZE                                             |
+--------------------------------------------------------------------------------+

The following shows an example of linking to a file using the specified DSECT name.

+--------------------------------------------------------------------------------+
|User:   ZUDFM OAI/IR20DF                                                        |
|                                                                                |
|System: UDFM0301I          FILE INFORMATION DISPLAY                             |
|        FILE IDENTIFIER               FDE9                                      |
|        FILE ADDRESS                            X F402E004                      |
|        FACE RECORD TYPE            D 00000190  X 000000BE                      |
|        FACE START ORDINAL          D 00000001  X 00000001                      |
|        FACE END ORDINAL            D 00000001  X 00000001                      |
|        CURRENT FACE ORDINAL        D 00000001  X 00000001                      |
|        CURRENT RELATIVE ORDINAL    D 00000000  X 00000000                      |
|        TPFDF ALGORITHM             D 00000004  X 00000004                      |
|        INITIAL NAB VALUE           D 00000026  X 0000001A                      |
|        TPFDF END ORDINAL           D 00000001  X 00000001                      |
|        VARIABLE LOGICAL RECORDSIZE                                             |
+--------------------------------------------------------------------------------+

The following shows an example of linking to a file using the ORDC and PTN2 parameters.

+--------------------------------------------------------------------------------+
|User:   ZUDFM OAI/FDE5/ORDC03/PTN2                                              |
|                                                                                |
|System: UDFM0301I          FILE INFORMATION DISPLAY                             |
|        FILE IDENTIFIER               FDE5                                      |
|        FILE ADDRESS                            X F40179C5                      |
|        FACE RECORD TYPE            D 00000165  X 000000A5                      |
|        FACE START ORDINAL          D 00000000  X 00000000                      |
|        FACE END ORDINAL            D 00000498  X 000001F2                      |
|        CURRENT FACE ORDINAL        D 00000113  X 00000071                      |
|        CURRENT RELATIVE ORDINAL    D 00000003  X 00000003                      |
|        CURRENT PARTITION           D 00000002  X 00000002                      |
|        TPFDF ALGORITHM             D 00000015  X 0000000F                      |
|        INITIAL NAB VALUE           D 00000026  X 0000001A                      |
|        TPFDF END ORDINAL           D 00000054  X 00000036                      |
|        VARIABLE LOGICAL RECORDSIZE                                             |
+--------------------------------------------------------------------------------+

The following example displays a new pool file address assigned to the specified file ID using the specified algorithm.

+--------------------------------------------------------------------------------+
|User:   ZUDFM OAI/FD01/CREATE/ALG-42                                            |
|                                                                                |
|System: UDFM0301I          FILE INFORMATION DISPLAY                             |
|        FILE IDENTIFIER               FD01                                      |
|        FILE ADDRESS                            X 00142909                      |
|        FACE RECORD TYPE            D 00000000  X 00000000                      |
|        FACE START ORDINAL          D 00000000  X 00000000                      |
|        FACE END ORDINAL            D 00000000  X 00000000                      |
|        CURRENT FACE ORDINAL        D 00000000  X 00000000                      |
|        CURRENT RELATIVE ORDINAL    D 00000000  X 00000000                      |
|        TPFDF ALGORITHM             D 00000255  X 000000FF                      |
|        INITIAL NAB VALUE           D 00000026  X 0000001A                      |
|        TPFDF END ORDINAL           D 00000000  X 00000000                      |
|        VARIABLE LOGICAL RECORDSIZE                                             |
+--------------------------------------------------------------------------------+

The following example displays the released pool file address associated with the specified algorithm and file ID.

+--------------------------------------------------------------------------------+
|User:   ZUDFM OAI/FD01/RELEASE/ALG-42                                           |
|                                                                                |
|System: UDFM0301I          FILE INFORMATION DISPLAY                             |
|        FILE IDENTIFIER               FD01                                      |
|        FILE ADDRESS                            X 00142909                      |
|        FACE RECORD TYPE            D 00000000  X 00000000                      |
|        FACE START ORDINAL          D 00000000  X 00000000                      |
|        FACE END ORDINAL            D 00000000  X 00000000                      |
|        CURRENT FACE ORDINAL        D 00000000  X 00000000                      |
|        CURRENT RELATIVE ORDINAL    D 00000000  X 00000000                      |
|        TPFDF ALGORITHM             D 00000255  X 000000FF                      |
|        INITIAL NAB VALUE           D 00000026  X 0000001A                      |
|        TPFDF END ORDINAL           D 00000000  X 00000000                      |
|        VARIABLE LOGICAL RECORDSIZE                                             |
+--------------------------------------------------------------------------------+

References

None.