Programming Interface Information:
This page documents intended Programming
Interfaces that allow the customer to write programs to obtain the services of VM/ESA. |
TVISECT
Cross Reference (Contains links to field and bit definitions)
TVISECT Prolog
Name : TVISECT Description: DMSTVI PLIST - Tape Volume Processing I-face DSECT : TVISECT Function : THIS MACRO MAPS THE PLIST THAT IS PASSED TO DMSTVI WHEN DMSTVI IS CALLED. THE ADDRESS OF THE PLIST IS IN REGISTER 1 WHEN DMSTVI IS CALLED. TVISECT is a parameter list that defines the input to a user supplied DMSTVI module. TVISECT is generated when the user issues the TVISECT macro. Notes : MODULE TYPE is MACRO PROCESSOR is ASSEMBLER F
TVISECT Control Block Content
TVISECT DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure TVISECT DMSTVI PLIST - Tape Volume Processing I-face 0000 0 Character 8 TVIMOD MODULE NAME FOR SVC 202 0008 8 Character 8 TVIFUNCT CALL FUNCTION KEYWORD SYSPARM - CALL FOR SYSPARM PROCESSING OPEN - CALL FROM OPEN MACRO VOLIDBAD - TAPE / USER SPECIFIED VOLIDS DO NOT MATCH EOV - CALL FOR END OF VOLUME CLOSE - CALL FROM CLOSE MACRO THE FOLLOWING FIELDS WILL BE FILLED IN FROM INFORMATION THAT IS STORED IN THE LABSECT. REFER TO THE LABELDEF COMMAND FOR MORE INFORMATION ABOUT THESE FIELDS. 0010 16 Character 8 TVIFILE DDNAME 0018 24 Character 17 TVIFID FILE ID (RIGHTMOST 17 CHARACTERS) 0029 41 Character 1 TVISEC SECURITY TYPE 002A 42 Character 6 TVIVOLID VOLUME ID TO BE MOUNTED 0030 48 Character 4 TVIVSEQ VOLUME SEQUENCE NUMBER 0034 52 Character 4 TVIFSEQ FILE SEQUENCE NUMBER 0038 56 Character 4 TVIGENN GENERATION NUMBER 003C 60 Character 2 TVIGENV GENERATION VERSION 003E 62 Character 6 TVICRD CREATION DATE 0044 68 Character 6 TVIEXD EXPIRATION DATE 004A 74 Signed 2 TVISYSPL LENGTH OF SYSPARM STRING 004C 76 Address 4 TVISYSPA ADDRESS OF SYSPARM STRING 0050 80 Character 44 TVIFILID FILE IDENTIFIER 007C 124 Character 8 TVISCRAT SCRATCH | NOSCRATC SCRATCH WAS (OR WAS NOT) SPECIFIED AS THE LABELDEF VOLID THE FOLLOWING FIELDS WILL BE FILLED IN FROM INFORMATION THAT IS STORED IN THE FCBSECT (SUPPLIED BY THE FILEDEF COMMAND). 0084 132 Character 4 TVICUU VIRTUAL DEVICE ADDRESS (TAP0 THROUGH TAPF) X'180' - X'187', X'288' - X'28F' 0088 136 Character 8 TVILABEL Filled with tape label type code 0090 144 Bitstring 1 TVIRFMT RECORDING FORMAT 00000090 TVIMODE TVIRFMT,1,C'X' Old label for TVIRFMT 0091 145 Character 4 TVIALT ALTERNATE TAPE DRIVE TAPE ID 0095 149 Character 6 TVIRING RING | NORING - WRITE ENABLE RING 009B 155 Bitstring 1 TVIFLAGS FLAG FOR TVI EXPANSION FIELDS BIT INDICATORS (MAY BE USED IN COMBINATIONS) X'00' NO EXPANSION DATA AVAILABLE X'80' DATA BEING PASSED FROM TAPE SUB-SYS X'40' - RESERVED - X'20' - RESERVED - X'10' - RESERVED - X'08' - RESERVED - X'04' - RESERVED - X'02' - RESERVED - X'01' EXPANSION DATA FIELDS AVAILABLE 009C 156 Signed 4 TVIBLKCT BLOCK COUNT -- EXPANSION DATA FIELDS ******************************---- THE FOLLOWING FIELDS WILL BE FILLED IN FROM INFORMATION THAT IS STORED IN THE APPLICATION PROGRAM DCB BLOCK AT "CLOSE" TIME TO BE MADE AVAILABLE TO THE TAPE SUBSYSTEM. IF THE TAPE SUBSYSTEM HAS THESE VALUES AVAILABLE WHEN THE DMSTVI "OPEN" CALL IS DONE, CMS WILL ACCEPT THESE VALUES AS RETURNED OUTPUTS FOR SUBSTITUTION INTO THE FCB (FILEDEF), IF THE USER HAS NOT ALREADY SPECIFIED THEM. THE FCB INFORMATION WILL THEN BE USED TO REPLACE ANY NON-SPECIFIED DCB ATTRIBUTES DURING THE CMS OPEN PROCESSING, JUST AS IS DONE FOR STANDARD LABEL TAPE PROCESSING. 00A0 160 Bitstring 1 TVIRECFM FILE RECORD FORMAT Basic record format bit definitions: X'80' = Fixed length records RECFM= F X'40' = Variable length records RECFM= V X'C0' = Undefined length records RECFM= U X'20' = ASCII Variable length records RECFM= D Modifiers which further define records: X'10' = Blocking being done X'08' = For Fixed records: Standard size blocks used For Variable recs: Spanned records used X'04' = ASA Control characters in use X'02' = Machine Control characters in use X'01' = Record Key length specified 00A4 164 Signed 4 TVILRECL FILE LOGICAL RECORD LENGTH 00A8 168 Signed 4 TVIBLKSI FILE BLOCK SIZE 00B0 176 Dbl-Word 8 TVIEND (0) END OF TVISECT 00000016 TVISIZE (*-TVISECT+7)/8 SIZE OF TVISECT IN DOUBLEWORDS
TVISECT Storage Layout
*** TVISECT - DMSTVI PLIST - Tape Volume Processing I-face * * +-------------------------------------------------------+ * 0 | TVIMOD | * +-------------------------------------------------------+ * 8 | TVIFUNCT | * +-------------------------------------------------------+ * 10 | TVIFILE | * +-------------------------------------------------------+ * 18 | | * = TVIFID = * | +------+-----------------------------------------+ * 28 | |TVISEC| TVIVOLID | * +------+------+-------------+---------------------------+ * 30 | TVIVSEQ | TVIFSEQ | * +---------------------------+-------------+-------------+ * 38 | TVIGENN | TVIGENV | (03E)- | * +---------------------------+-------------+-------------+ * 40 | -TVICRD | TVIEXD- | * +-------------+-------------+---------------------------+ * 48 | -(044) | TVISYSPL | TVISYSPA | * +-------------+-------------+---------------------------+ * 50 | | * = TVIFILID = * | +---------------------------+ * | | TVISCRAT- | * +---------------------------+---------------------------+ * 80 | -(07C) | TVICUU | * +---------------------------+---------------------------+ * 88 | TVILABEL | * +------+---------------------------+--------------------+ * 90 |:RFMT | TVIALT | TVIRING- | * +------+-------------+------+------+--------------------+ * 98 | -(095) |:FLAGS| TVIBLKCT | * +------+-------------+------+---------------------------+ * A0 |:RECFM|////////////////////| TVILRECL | * +------+--------------------+---------------------------+ * A8 | TVIBLKSI |///////////////////////////| * +---------------------------+---------------------------+ * B0 | | * = TVIEND = * | | * +-------------------------------------------------------+ * *** TVISECT - DMSTVI PLIST - Tape Volume Processing I-face
TVISECT Cross Reference
(contains links to field and bit definitions)Symbol Dspl Value -------------- ---- -----TVIALT 0091
TVIBLKCT 009C
TVIBLKSI 00A8
TVICRD 003E
TVICUU 0084
TVIEND 00B0
TVIEXD 0044
TVIFID 0018
TVIFILE 0010
TVIFILID 0050
TVIFLAGS 009B
TVIFSEQ 0034
TVIFUNCT 0008
TVIGENN 0038
TVIGENV 003C
TVILABEL 0088
TVILRECL 00A4
TVIMOD 0000
TVIMODE 0090 00000090
TVIRECFM 00A0
TVIRFMT 0090
TVIRING 0095
TVISCRAT 007C
TVISEC 0029
TVISIZE 00B0 00000016
TVISYSPA 004C
TVISYSPL 004A
TVIVOLID 002A
TVIVSEQ 0030
Last updated on 18 Aug 1999 at 09:19:45 EDT.
Copyright IBM Corporation, 1990, 1999