The GETXDEP service returns information from the Cross-dependency database associated with the specified SCLM-managed member. The information is returned in an ISPF table. One row is returned for each child-parent dependency found.

Command invocation format

>>-FLMCMD--GETXDEP,project,--prj_def--,--group--,--type--,------>

>--member--,--xdep_table--,--scope,--+---------+---------------><
                                     '-dd_msgs-'   

Call invocation format

>>-Lastrc--:=--FLMLNK('GETXDEP',sclm_id,--group--,--type--,----->

>--member--,--xdep_table--,--scope,--$msg_array);--------------><

Parameters

project

The project name.

prj_def

The project definition name.

group

The group associated with the accounting record.

type

The type associated with the accounting record.

member

The member under SCLM control.

xdep_table

The name of the ISPF table to contain the cross-dependency entries. The table must be open before calling the GETXDEP service. A TBADD is performed for each cross-dependency record found. The following ISPF variables must be defined to the table in order to have their value stored in the table:

ZSFGROUP

Initial group (same on all records).

ZSFSCOPE

Scope (same on all records).

ZSFLEVEL

Nesting level.

ZSFCNAME^{Note 1}

Child object - name.

ZSFCPGRP^{Note 1}

Child object - group.

ZSFCTYPE^{Note 1}

Child object - type.

ZSFCLANG^{Note 1}

Child object - language.

ZSFCPBGRP^{Note 1}

Child object - group (buildmap).

ZSFCBLNG^{Note 1}

Child object - language (buildmap).

ZSFCNUMP^{Note 1}

Child object - number of parents.

ZSFPKWRD

Parent object - include keyword.

ZSFPNAME

Parent object - name.

ZSFPTYPE

Parent object - account type.

ZSFPGRP

Parent object - account group.

ZSFPBGRP

Parent object - buildmap group.

ZSFPLANG

Parent object - account language.

ZSFPBLNG

Parent object - buildmap language.

ZSFPNUMP

Parent object - number of parents.

ZSFLIMIT

Limited list = blank, "CIRC", or "MAX".

Note:

1. The ZSFC** fields are repeated for each of their parent rows.

scope

Valid values are:

NEXT

Just return immediate parents.

ALL

Return all parents.

LMOD

Stop at LECMAP archdefs.

TOPSRC

Stop at CCMAP archdefs.

dd_msgs

The ddname indicating the destination of the messages generated by the GETXDEP service. If you specify a blank ddname, SCLM routes the GETXDEP messages to the default output device, such as your terminal. Otherwise, before you call the GETXDEP service, you must allocate the ddname. The following attributes should be used: RECFM=F, LRECL=80, BLKSIZE=80. The maximum parameter length is 8 characters. This parameter is used for FLMCMD only.

$msg_array

An output parameter pointing to the message array. See the section "Pointer Parameter Descriptions" in Chapter 16,"Invoking the SCLM services" for more information about $msg_array. This parameter is used for FLMLNK only.

Return codes

0

GETXDEP completed successfully.

4

The parent chain was truncated when the maximum nesting level was exceeded, or a circular reference was detected. ZSFLIMIT is non-blank on truncated rows.

8

No parent data was found.

12

Cross-dependency database is not active.

16

Error updating ISPF table.

20

Error reading the Cross-dependency database.