XLINK DISPLAY

Read syntax diagramSkip visual syntax diagram XLINK Display vaddr (1NOHeaderSTACKFIFOLIFOCYL( nnnnn))
Notes:
  • 1 You can enter options in any order between the parentheses.

Purpose

Use the XLINK DISPLAY utility to display link indicators in the map records of all systems on a particular device.

If a system is defined as a member of an SSI cluster, XLINK DISPLAY is not allowed.

Operands

vaddr
specifies the virtual address of the device. This can be one of the following:
  • A full-pack minidisk that defines the entire real volume
  • The real volume attached to you at address vaddr
  • A minidisk defining the cylinder on the volume that contains the CSE area.
NOHeader
keeps the descriptive column header information from being put on the CMS stack.
STACK
FIFO
LIFO
puts the information in the CMS program stack (for use by an EXEC or other program) instead of displaying it at the terminal. The information is stacked either FIFO (first in first out) or LIFO (last in first out). The options STACK and FIFO are equivalent.
CYL(nnnnn)
limits the display to the information for one minidisk starting on a specific cylinder.

Usage Notes

  1. The cross system extensions (CSE) environment is not supported. However, the cross-system link (XLINK) function that was included in CSE is still supported for non-SSI systems, and CSE is still used in some function and object names, command responses, and messages related to XLINK.
  2. By default, the XLINK DISPLAY utility is located on the system tools disk (MAINT 193).
  3. This utility requires read access to the device listed as vaddr.

Responses

Response 1:

The normal response to the XLINK DISPLAY utility is: 
HCPXXL2867I  VOLSER volid NOT IN INCLUDE LIST, DEVTYPE CSE
             DEFAULTS WILL BE USED.
 
HCPXXL2876I  VOLUME volid WAS FORMATTED FOR CSE ON
             mm/dd/yy AT hh:mm:ss
             BY USER userid AT SYSTEM sysname
 
             -CYL- READ/WRITE FLAGS ON volid (CYL=c TRK=t
             RECL=l RECS=r SYSTEMS=s)
 
             ccccc    mode      sysname2      . . .    . . .    . . .
                                . . .         . . .    . . .    . . .
                                . . .         . . .    . . .    . . .
- or -
             -----  NO LINK FLAGS ON THIS VOLUME
volid
identifies the volume identifier of the specified device.
userid
identifies the user who formatted the CSE area on volume volid.
sysname
identifies the system from which the CSE area for this volume was formatted.
c
identifies the cylinder number where the CSE area was formatted.
t
identifies the track number of the CSE area.
l
identifies the number of cylinders made available for XLINK use. For CKD devices it is also the length of the XLINK map records.
r
identifies the number of XLINK records written on the CSE area.
s
identifies the number of systems that can share this DASD volume.
ccccc
identifies the starting cylinder of an MDISK on volume vvvvvv that has link flags outstanding by one or more systems.
mode
identifies the link mode, currently in effect for this MDISK by system sysname2. The possible mode values are:
Read on
Read-only access
Write on
Read and write access
SRead on
Read-only access and negates all write access requests.
SWrite on
Read and write access and negates all write access requests.
ERead on
Read-only access and negates all other access requests.
EWrite on
Read and write access and negates all other access requests.
sysname2
identifies the name of the system that has a read or write link to the MDISK that begins on cylinder ccccc.

Messages

  • HCP1667E THE XLINK UTILITY IS NOT ALLOWED BECAUSE THE SYSTEM IS A MEMBER OF AN SSI CLUSTER.
  • HCP2861E MISSING OR INVALID FUNCTION: subcommand
  • HCP2862E VOLSER volid IS NOT A CP FORMATTED VOLUME
  • HCP2863E DIAG-A8 I/O ERROR, CC=n R15=hhhhhhhh SCSW=hhhhhhhh SENSE=hhhhhhhh
  • HCP2864E DEVICE ADDRESS ccuu IS INVALID OR NOT OPERATIONAL
  • HCP2870E ERROR nnn ON CMSSTOR CALL
  • HCP2871E INVALID OPTION: option
  • HCP2872E COMMAND LINE TOO LONG FOR CP. CP CAN ACCEPT NO MORE THAN 240 CHARACTERS - YOUR COMMAND WAS nnn CHARACTERS IN LENGTH
  • HCP2873E MISSING OR INVALID PARAMETER OR OPTION
  • HCP2874E DEVICE vdev IS NOT A CKD OR ECKD DASD DEVICE.
  • HCP2877E EITHER NOT A CSE VOLUME, OR CSE DATA IS NOT ON CYL ccccc TRK tt