Displaying all or part of the distribution table (&DISPLAY DISTRIBUTION)

For UDS-D

 &DISPLAY DISTRIBUTION
   [,NODE=processor-name]
   [,CONF=confname]
   [,DB=dbname]
   [,SS=subschema-name]

processor-name

Name of a host; must be no more than eight characters in length.

confname

The first eight characters of configuration-name; must be unique in its first seven characters. The eighth character must not be ’@’. Trailing zeros are nonsignificant characters, i.e. there is no difference between confname ABC and confname ABC0.

dbname

Name of a database;
must be unique network-wide.

The specification :catid:$userid.dbname.realm-name.copy-name may be at most 54 characters in length.

subschema-name

Name of a subschema; may be at most 30 characters in length; must be unique network-wide in its first six characters.

Locked entries are identified with a prefixed minus sign.

Distribution table output is limited to 32 KB. If the distribution table is larger than this then it is not output in full and a message is issued to inform you of this.

UDS-D displays the following information on the display terminal:

If &DISPLAY DISTRIBUTION is specified without operands, the entire local distribution table is shown:

Example 1
//EXECUTE-DAL-CMD CMD=&DISPLAY DISTRIBUTION

%  UDS0220 UDS RECEIVED COMMAND: &DISPLAY DISTRIBUTION (OPCC074,09:29:40/4TMW) 
4TMW: =================================================================
4TMW:  NODE-NAME  CONF-NAME  DB-NAME                      SS-NAME
4TMW: =================================================================
4TMW:   PROZ1      CONF3      DB11                         SS111
4TMW:                                                     -SS112
4TMW:                        ------------------------------------------
4TMW:                         DB12                         SS121
4TMW:                                                      SS122
4TMW: -----------------------------------------------------------------
4TMW:   PROZ2      CONF4      DB21                         SS21
4TMW:                        ------------------------------------------
4TMW:                         DB22                         SS22
4TMW: -----------------------------------------------------------------
%  UDS0832 UDS-D: COMMAND EXECUTED  (OPCC382,09:29:48/4TMW)

If &DISPLAY DISTRIBUTION is specified with one operand, the given operand and its immediate neighbors in the distribution table are shown:

Example 2
//EXECUTE-DAL-CMD CMD=&DISPLAY DISTRIBUTION,DB=DB11

%  UDS0220 UDS RECEIVED COMMAND: &DISPLAY DISTRIBUTION,DB=DB11 (OPOX073,09:29:50/4TMW) 
4TMW: =================================================================
4TMW:  NODE-NAME  CONF-NAME  DB-NAME                     SS-NAME
4TMW: =================================================================
4TMW:             CONF3      DB11                        SS111
4TMW:                                                   -SS112
              
4TMW: -----------------------------------------------------------------
%  UDS0832 UDS-D: COMMAND EXECUTED  (OPCC382,09:29:50/4TMW)

If &DISPLAY DISTRIBUTION is specified with more than one operand, the given operands and their immediate neighbors in the distribution table are shown:

Example 3
//EXECUTE-DAL-CMD CMD=&DISPLAY DISTRIBUTION,CONF=CONF3,DB=DB11

%  UDS0220 UDS RECEIVED COMMAND: &DISPLAY DISTRIBUTION,CONF=CONF3,DB=DB11 (OPOX073,09:29:52/4TMW) 
4TMW: =================================================================
4TMW:  NODE-NAME  CONF-NAME  DB-NAME                      SS-NAME
4TMW: =================================================================
4TMW:   PROZ1      CONF3     DB11                          SS111
4TMW:                                                     -SS112
              
0YBI: -----------------------------------------------------------------
%  UDS0832 UDS-D: COMMAND EXECUTED  (OPCC382,09:29:52/4TMW)