LOCATE SNABK
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
- 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.
- Blanks are not permitted between the netname, ., and luname.
- Network qualifiers, if they exist will be displayed only if a netname is specified.
- 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