GETFMADR

Read syntax diagramSkip visual syntax diagram GETFMADR 0120starting_disk_address( SEQ)

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

  1. 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
  2. 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.
  3. GETFMADR with the SEQ option will return the starting address of the first free address it finds.
  4. 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)