Description
CAP _SIZE is the number of storage cells in a CAP.
Definition
The CAP storage cells are arranged in three rows of seven columns.
Therefore, CAP _ SIZE is defined as:
tdefine CAP SIZE 21
ACSLM Common Data Structures Common Variables
CELLID
Description
CELLID uniquely identifies a storage cell within an ACS.
Definition
CELLID contains an ACS identifier, an LSM number, a panel number, a panel row number, and a panel column number.
typedef struct { PANELID panel_id;
ROW row;
COL col;
CELLID;
row is defined as:
typedef unsigned char ROW;
row has a range from MIN_ROW to MAX_ROW which are defined as:
tdefine MIN ROW 0 fdefine MAX ROW 14 col is defined as:
typedef unsigned char COL;
col has a range from MIN_COLUMN to MAX_COLUMN which are defined as:
fdefine MIN COL 0 tdefine MAX COL 23
COMMAND
Description
Values
COMMAND uniquely identifies an operation to the ACSLM.
COMMAND can be any of the following. (See the de/s.h Header File in Appendix B for the "C" enumeration values.)
COMMAND ABORT COMMAND AUDIT COMMAND CANCEL COMMAND DISMOUNT COMMAND EJECT
Common Variables ACSLM Common Data Structures
COMMAND_RECOVERY COMMAND START COMMAND_TERMINATE COMMAND_VARY
COMMAND_ABORT, COMMAND_RECOVERY, COMMAND_TERMINATE, and
COMMAND_UNSOLICITED_EVENT are for ACSLM internal use only. All other COMMAND values can be generated by a client application.
DRIVEID
Description
DRIVEID uniquely identifies a library drive within the library.
Definition
DRIVEID contains an ACS identifier, an LSM number, a panel number, and a drive number:
typedef struct { PANELID panel_id;
DRIVE drive_number;
DRIVEIDi
drive_number is defined as:
typedef unsigned char DRIVE;
drive_number has a range from MIN_DRIVE to MAX_DRIVE which are defined as:
idefine MIN DRIVE 0 idefine MAX DRIVE 3
FREECELLS
Description
FREECELLS is the number of unoccupied cells in an ACS or LSM.
Definition
FREECELLS is defined as:
typedef unsigned long FREECELLSi
ACSLM Common Data Structures
FUNCTION
Description
Values
LOCATION
FUNCTION is an action performed by the ACSLM.
FUNCTION can have the following values:
audit cancel dismount eject enter idle
initiation mount query recovery start
termination
Description
LOCATION describes the class of storage location.
Values
Common Variables
LOCATION can be any of the following. (See the db _de/s.h Header File in Appendix B for the "C" enumeration values.)
LSMID
LOCATION CELL
LOCATION DRIVE
Description
LSMID uniquely identifies an LSM within a library.
Definition
LSMID contains an ACS identifier and an LSM number.
typedef struct { ACS acs _number;
LSM Ism_number;
Common Variables ACSLM Common Data Structures
MAX 10
Ism number is defined as:
typedef unsigned char LSM;
Ism_number has a range from MIN_LSM to MAX_LSM which are defined as:
#define MIN LSM 0
#define MAX_LSM 15
Description
MAX_ACS_DRIVES is the maximum number of drives in the library.
Definition
MAX ACS DRIVES is defined as:
#define MAX ACS DRIVES 128
Description
MAX _ ID is the maximum number of identifiers that can be specified in a request.
Definition
MAX ID is defined as:
#define MAX ID 21
Description
MAX_MESSAGE_SIZE is the maximum size of an IPC request or response packet
Definition
MAX MESSAGE SIZE - - is defined as:
Description
MAX_PORTS is the maximum number of ports per ACS.
ACSLM Common Data Structures Common Variables
Definition
MAX PORTS is defined as:
fdefine MAX PORTS 16
MESSAGE 10
Description
MESSAGE_ID is a unique number generated and used by the ACSLM to identify a specific request from a CSI or the ACSSA.
Definition
MESSAGE_IO is defined as:
typedef unsigned short MESSAGE_IO;
MESSAGE_IO has a range from MIN_MESSAGE to MAX_MESSAGE which are defined as:
fdefine MIN MESSAGE 1 fdefine MAX MESSAGE 65535
PANELIO
Description
PANELIO uniquely identifies a storage panel within an ACS.
Definition
The panel identifier contains an ACS identifier, an LSM number, and a panel number:
typedef struct { LSMIO lsmjd;
PANEL panel_number;
PANELIO;
panetnumber is defined as:
typedef unsigned char PANEL;
panetnumber values can range from MIN_PANEL to MAX_PANEL which are defined as:
fdefine MIN PANEL 0 fdefine MAX PANEL 19
Common Variables ACSLM Common Data Structures
PORTIO
STATE
Description
PORTIO uniquely identifies a single communication line between a server system communications port and an LMU host interface. The ACSLM uses the communication line to interact with an ACS.
Definition
PORT _ ID contains an ACS identifier and a port number:
typedef struct { ACS acs_id;
PORT port_number;
PORTIO;
port_number is defined as;
typedef unsigned char PORTi
port_number values can range from MIN_PORT to MAX_PORT which are defined as:
fdefine MIN PORT 0 fdefine MAX PORT 15
Description
Values
STATE describes the characteristics that a device or Storage Server component can take.
STATE can be any of the following. (See the db _de/s.h Header File in Appendix B for the "C" enumeration values.)
STATE CANCELLED STATE DIAGNOSTIC STATE IDLE
STATE IDLE PENDING -
-STATE OFFLINE
STATE_OFFLINE_PENDING STATE ONLINE
STATE RECOVERY STATE RUN
STATE_CANCELLED describes a state of a request.
STATE ONLINE,STATE OFFLINE,STATE OFFLINE_PENDING, and
STATE_DIAGNOSTIC describe the different states of an ACS, LSM, or
ACSLM Common Data Structures Common Variables
STATE_ONLINE and STATE_OFFLINE describe the different states of a port:
STATE_RUN,STATE_IDLE,STATE_IDLE_PENDING,andsTATE_RECOVERY describe the different states of the ACSLM.
SUBPANELID
TYPE
Description
SUBPANELID uniquely identifies a subset of cells within a panel. It specifies the upper-left corner (startrow, startcolumn) and lower-right comer (endrow, endcolumn) of a rectangular area wholly contained in a single panel.
Definition
SUBPANELID contains an ACS identifier, an LSM number, a panel number, a starting row number, a starting column number, an ending row number, and an ending column number:
typedef struct {
TYPE identifies a class of devices, Storage Server software components, or commands.
Valid TYPE values and their defmitions are as follows. (See the defs.h Header File in Appendix B for the
"c"
enumeration values.)TYPE ACS Cartridge Access Port (CAP) Cell identifier
ACSSA command process CSI
Common Variables ACSLM Common Data Structures
ACS Library Manager (ACSLM) LSM
mount request process no identifier specified LSMpanel
ACS communication port
query request process
Storage Server recovery process Storage Server request
ACS System Administrator (ACSSA) Storage Server
LSM subpanel
vary request process Tape cartridge
VaLID is the external tape cartridge label which uniquely identifies a tape cartridge within an ACS.
Definition
VaLID is defined as:
typedef struct
char external_label[EXTERNAL LABEL SIZE+l];
} VaLID;
EXTERNAL LABEL SIZE is defined as:
VaLID is a string of characters less than or equal to
EXTERNAL_LABEL_SIZE characters long and null tenninated. The uppercase characters ("A" through "Z"), digits ("0" through "9"), and blank (" ") are valid. VOLIDs containing embedded blanks are reserved for diagnostic and maintenance cartridges only; leading and trailing blanks are ignored.