LCS optical cartridge entry, eject, label, audit, mount, and demount (subtypes 68–73)

Table 1 describes the format of the subtype data section for the following OAM SMF record subtypes:

68: LCS optical cartridge entry
69: LCS optical cartridge eject
70: LCS optical cartridge label
71: LCS optical volume audit
72: LCS optical volume mount
73: LCS optical volume demount

Table 1. Format of the subtype data section for subtypes 68–73
Offsets	Name	Length	Format	Description
0 0	ST68OLN	8	EBCDIC	Optical library name. This field contains the real library name of an operator-accessible drive.
8 8	ST68OLDT	8	EBCDIC	Optical library device type.
16 10	ST68OLDN	4	EBCDIC	MVS device number that corresponds to the optical library.
20 14	ST68ODN	8	EBCDIC	Optical drive name.
28 1C	ST68ODDT	8	EBCDIC	Optical drive device type.
36 24	ST68ODDN	4	EBCDIC	MVS device number that corresponds to the optical drive.
40 28	ST68VSN0	6	EBCDIC	Volume serial number.
46 2E	ST68VSN1	6	EBCDIC	Volume serial number of the opposite side of the optical disk.
52 34	ST68OMT	2	EBCDIC	Optical media type Value Meaning 01 IBM 3995 5.25-inch 650-MB rewritable optical disk media. 03 IBM 3995 5.25-inch 650-MB WORM optical disk media. 11 IBM 3995 5.25-inch 1300-MB rewritable optical disk media. 13 IBM 3995 5.25-inch 1300-MB WORM optical disk media. 15 IBM 3995 5.25-inch 1300-MB CCW optical disk media. 21 IBM 3995 5.25-inch 2600-MB rewritable optical disk media. 23 IBM 3995 5.25-inch 2600-MB WORM optical disk media. 25 IBM 3995 5.25-inch 2600-MB CCW optical disk media. 31 IBM 3995 5.25-inch 5.2-GB rewritable optical disk media. 33 IBM 3995 5.25-inch 5.2-GB WORM optical disk media. 35 IBM 3995 5.25-inch 5.2-GB CCW optical disk media. Note: CCW = continuous composite WORM media. WORM = write-once-read-many.
54 36	ST68ODT	1	EBCDIC	Optical drive type: Value Meaning L Optical drive is a library-resident drive. S Optical drive is a stand-alone or operator-accessible drive.
55 37	ST68OVT	1	EBCDIC	Optical volume type: Value Meaning B Optical volume is a backup volume belonging to an OBJECT BACKUP storage group. G Optical volume is a grouped volume belonging to an OBJECT storage group. S Optical volume is a scratch volume.
56 38	ST68SGN	8	EBCDIC	Storage group name.
64 40	ST68LIQT	4	binary	LCS input-work-queue time. The amount of time in milliseconds this request has spent on the LCS input-work-queue waiting to be processed.
68 44	ST68LDQT	4	binary	LCS dispatcher-queue time. The amount of time in milliseconds this request has spent on the LCS dispatcher-queue waiting to be processed.
72 48	ST68LEQT	4	binary	LCS execution-queue time. The amount of time in milliseconds this request has spent on the LCS execution-queue being processed.
76 4C	ST68LTQT	4	binary	LCS library task queue time. The amount of time in milliseconds this request has spent on the LCS library queue waiting to be processed. Normally, this field represents the cartridge transport mechanism wait time. That is, the time spent waiting for the cartridge transport mechanism within the automated optical disk library to become available.
80 50	ST68LTPT	4	binary	LCS library task processing time. The amount of time in milliseconds this request took to be processed by the library task. Normally, this field represents the cartridge transport mechanism service time. That is, the time spent by the cartridge transport mechanism within the automated optical disk library performing mechanical motion to move cartridges within the optical disk library.
84 54	ST68RC	4	binary	LCS return code.
88 58	ST68RS	4	binary	LCS reason code.
92 5C	ST68FLGS	4	binary	Processing flags. The meaning is dependent on the record subtype. The following bit definitions apply for record subtype 68: Bit Meaning 0 When on, the volume serial number described by field ST68VSN0 required formatting as part of the optical cartridge entry processing. 1 When on, the volume serial number described by field ST68VSN1 required formatting as part of optical cartridge entry processing. 2 When on, the volume serial number described by field ST68VSN0 was not known to OAM at the time of being entered into the optical library. There was no row for this optical disk volume in the Volume table in the OCDB. 3 When on, the volume serial number described by field ST68VSN1 was not known to OAM at the time of being entered into the optical library. There was no row for this optical disk volume in the Volume table in the OCDB. 4–31 Reserved.
92 5C	ST69FLGS	4	binary	Processing flags. The meaning is dependent on the record subtype. The following bit definitions apply for record subtype 69: Bit Meaning 0 When on, this optical cartridge was automatically ejected by the system due to an error condition known as a system-initiated eject request. 1–31 Reserved.
92 5C	ST70FLGS	4	binary	Processing flags. The meaning is dependent on the record subtype. The following bit definitions apply for record subtype 70: Bit Meaning 0–31 Reserved.
92 5C	ST71FLGS	4	binary	Processing flags. The meaning is dependent on the record subtype. The following bit definitions apply for record subtype 71: Bit Meaning 0–31 Reserved.
92 5C	ST72FLGS	4	binary	Processing flags. The meaning is dependent on the record subtype. The following bit definitions apply for record subtype 72: Bit Meaning 0 When on, the volume serial number described by field ST68VSN0 required formatting as part of the optical volume mount processing. 1 When on, the volume serial number described by field ST68VSN1 required formatting as part of the optical volume mount processing. 2–31 Reserved.
92 5C	ST73FLGS	4	binary	Processing flags. The meaning is dependent on the record subtype. The following bit definitions apply for record subtype 73: Bit Meaning 0–31 Reserved.
96 60	ST68TMNT	4	binary	Elapsed time in milliseconds that the optical disk volume was mounted. Valid for subtypes 69 and 73.
100 64	ST68NOW	4	binary	Number of objects written to this optical disk volume while it was mounted. Valid for subtypes 69 and 73.
104 68	ST68NKBW	4	binary	Number of kilobytes of object data written to this optical disk volume while it was mounted. Valid for subtypes 69 and 73.
108 6C	ST68NOR	4	binary	Number of objects read from this optical disk volume while it was mounted. Valid for subtypes 69 and 73.
112 70	ST68NKBR	4	binary	Number of kilobytes of object data read from this optical disk volume while it was mounted. Valid for subtypes 69 and 73.
116 74	ST68NOD	4	binary	Number of objects deleted from this optical disk volume while it was mounted. Valid for subtypes 69 and 73.
120 78	ST68NKBD	4	binary	Number of kilobytes of object data deleted from this optical disk volume while it was mounted. Valid for subtypes 69 and 73.
Note: For subtypes 69 and 73, each object size is rounded up to the next whole KB before being added to the total.

Although subtypes 68–73 share a common subtype data section, not all fields are valid for each of the six subtypes. Table 2 identifies which fields in the OAM subtype data section are valid for each of the six subtypes.

Table 2. Valid subtype data section fields for subtypes 68–73
Field name	Optical cartridge entry subtype 68	Optical cartridge eject subtype 69	Optical cartridge label subtype 70	Optical volume audit subtype 71	Optical volume mount subtype 72	Optical volume demount subtype 73
ST68OLN	X	X	X	X	X	X
ST68OLDT	X	X	X	X	X	X
ST68OLDN	X	X	X	X	X	X
ST68ODN	X	See table note.	X	X	X	X
ST68ODDT	X	See table note.	X	X	X	X
ST68ODDN	X	See table note.	X	X	X	X
ST68VSN0	X	X	X	X	X	X
ST68VSN1	X	X	X	X	X	X
ST68OMT	X	X	X	X	X	X
ST68ODT	X	See table note.	X	X	X	X
ST68OVT	X	X	X	X	X	X
ST68SGN	X	X	X	X	X	X
ST68LIQT		X	X	X
ST68LDQT	X	X	X	X
ST668LEQT	X	X	X	X
ST68LTQT		X		X
ST68LTPT		X		X
ST68RC	X	X	X	X	X	X
ST68RS	X	X	X	X	X	X
ST68FLGS	X	X	X	X	X	X
ST68TMNT		See table note.				X
ST68NOW		See table note.				X
ST68NKBW		See table note.				X
ST68NOR		See table note.				X
ST68NKBR		See table note.				X
ST68NOD		See table note.				X
ST68NKBD		See table note.				X
Note: This field contains valid data if the optical disk volume being ejected is mounted in an optical disk drive at the time that the LIBRARY,EJECT,volser command or F OAM,EJECT,volser command is received to eject the volume.