LOCATE SNABK

Read syntax diagramSkip visual syntax diagram LOCate SNABK netname. luname VSMuserid*

Authorization

Privilege Class: C, E

Purpose

Use LOCATE SNABK to display the address of the system SNA control block (SNABK).

Operands

netname.
is the network qualifier of the fully qualified logical unit name (netname.luname). The period is used to delimit the network name from the LU name. This tells CP to locate the control blocks for only those terminal names that match this pattern.
luname
tells CP to locate the control blocks for only those terminal names that match this pattern.
VSM
tells CP to display the addresses for those SNA control blocks under the control of any VTAM® Service Machine whose user ID matches the pattern userid.
userid
tells CP to locate the SNABK entries for the user ID or user ID pattern specified. For more information on user ID patterns, see Usage Note 1.
*
tells CP to locate the SNABK entries for your user ID.

Usage Notes

  1. Pattern matching follows the rules used by the CMS LISTFILE command. Use an asterisk (*) to match any number of characters; use a percent symbol (%) to match any single character.
  2. Blanks are not permitted between the netname, ., and luname.
  3. Network qualifiers, if they exist will be displayed only if a netname is specified.
  4. Multiple responses can occur with the same luname when a netname. is not specified and one or more VSMs support network qualified names.

Responses

Response 1:

LU Name  RDEV     SNABK    VSM
luname   nnnnnnnn nnnnnnnn userid
LU Name
shows the name of the logical unit.
RDEV
shows the host logical storage address of the real device block.
SNABK
shows the host logical storage address of the SNA control block.
VSM
shows the user ID of the VTAM service machine (VSM) controlling the SNABK.

Examples

Example 1:

If you enter a LOCATE SNABK command without the VSM operand, you may see something like this:
locate snabk wgu*
LU Name  RDEV     SNABK    VSM
WGU00315 044D9060 044D9008 VTAM
Ready;

Example 2:

If you add the netname to the request the response shows the fully qualified network name and might look like this:
locate snabk *.*
LU Name           RDEV     SNABK    VSM
VTAM1.LU3E0       0667DCD0 0667DC68 VTAM
VTAM1.LU3E1       07077D88 07077D20 VTAM
Ready;
The same request without the netname might look like this:
locate snabk *
LU Name  RDEV     SNABK    VSM
LU3E0    0667DCD0 0667DC68 VTAM
LU3E1    07077D88 07077D20 VTAM
Ready;

Example 3:

You can request the addresses of the SNA control blocks for all the logical devices under the control of a specific VSM. For example, to show the relevant information for all the terminals whose names start with the characters TN6 that are logged on under VTAM2, enter:
locate snabk tn6* vsm vtam*
LU Name  RDEV     SNABK    VSM
TN6PV095 044D92A0 044D9248 VTAM2
Ready;

Messages

  • HCP002E Invalid operand - operand
  • HCP003E Invalid option - command contains extra option(s) starting with option
  • HCP020E Userid missing or invalid
  • HCP026E Operand missing or invalid
  • HCP6720I No items found to satisfy selection criteria