GETFMADR
Authorization
General User
Purpose
Use the GETFMADR command to stack the first available file mode and an available virtual disk address. An exec can use this information to link and access a minidisk or access a shared file system (SFS) directory without disturbing existing links or accesses.
Operands
- starting_disk_address
- is the optional virtual disk address, which overrides the default of 0120.
- SEQ
- causes a sequential search for a free virtual disk address beginning at the specified address or the default address 0120. This option finds the first available virtual disk address without searching through the entire virtual control unit (VCU) range of addresses. The SEQ option overrides the default search for the first free VCU address.
Usage Notes
- The format of the stacked line is:
- Token
- Content
- 1
- * (viewed as a comment by CMS)
- 2
- the first free mode letter (or Z if none are free)
- 3
- a free virtual disk address
- 4
- the current minidisk now accessed as Z, or 0000 if an SFS directory is now accessed as Z
- GETFMADR without the SEQ option will search for a free virtual disk address beginning at the address you specify, or 0120 by default. It will return the starting address of the first free VCU or, if there are not any free VCUs, the first free address it finds. A VCU is free if there are no devices in the range of 16 addresses, xxx0 - xxxF, the VCU covers.
- GETFMADR with the SEQ option will return the starting address of the first free address it finds.
- The stacked line's fourth token is present only if all modes (including Z) are in use. Therefore, check token 4 to determine if there are any free file modes.
Messages and Return Codes
System messages may be issued by this command. The reasons for these messages and their location are:
Reason | Location |
---|---|
Errors in command syntax | Command Syntax Error Messages |
Return codes:
- RC
- Meaning
- 0
- Command complete—no errors
- xx
- where xx is RC from PARSECMD or CMSCALL
- 100
- Explanation complete (when ‘?‘ specified)