(SYSLIB) Programming Reference Manual - Public Support Login ...

More documents

Recommendations

Info

SYSLIB Access Methods All the SYSLIB routines are available as relocatable elements. The routines listed at the beginning of this section are also available as common bank routines. For the SYSLIB routines CABSAD$, CONWRD$, CRELAD$, GETPSF$, ID$, INFOR$, MFDSP$, and SFDT$, SYSLIB provides procedures that generate the calling sequence to access these routines. These procedures have been provided for the convenience of the calling program. Through the use of a parameter on the procedure call, they allow the calling program to access the relocatable version of the SYSLIB routine, the common bank version of the SYSLIB routine using the I$BJ calling sequence or the common bank version of the SYSLIB routine using the Auto Switch calling method. One of the advantages of using these procedures is that if a change to the calling sequence of the routine has to be made, an internal change to the SYSLIB calling procedure can also be made, and the calling program can remain the same. For the SYSLIB routines that do not have a procedure provided to generate the calling sequence, the calling program must explicitly code these instructions. The method for calling a particular SYSLIB routine is contained in the chapter describing the routine. Some general considerations on the different types of calls are given in the following subsections. 3.1. Relocatable Collection Method The Relocatable Collection method causes the SYSLIB relocatable element to be collected into the calling program and become an integral part of it. Once this has been done, the resulting absolute element will not be affected by any changes made to the version of SYSLIB on the system. In other words, any SYSLIB routines the program requires are retrieved from the system library file and collected along with the other relocatable elements of the program to form an absolute element. If this type of call to SYSLIB is used, the resulting absolute can be transported from one system to another without regard as to what level of SYSLIB is on the other machine. Also, any changes made to SYSLIB after the program has been collected have no effect on how the program performs. For the SYSLIB routines that have a procedure to generate the calling sequence, this is the type of call that is generated as the default if the Common Bank call or Auto Switch call are not requested. 3–2 7833 1733–004
3.2. Common Bank Call Using I$BJ SYSLIB Access Methods The I$BJ calling sequence is the preferred method of calling the SYSLIB common bank routines. For the SYSLIB routines with a calling procedure, this is the type of call that is generated when the calling program sets the parameter on the call to access the common bank version of the routine. This method provides a much more flexible means of using the SYSLIB routines than the Auto Switch method or explicitly coding an LIJ instruction, and it retains all the advantages associated with using the common bank version of the routines. That is, the calling program remains small because the SYSLIB routines do not become an actual part of the calling program absolute. In addition, the calling program will automatically reference new versions of the SYSLIB routines as they are installed without the need for the calling program to be recompiled or re-collected. Another advantage to using the I$BJ calling sequence is that the calling program can switch between using the common bank version of the routines and the relocatable version of the routines by re-collecting the program with the proper collector EQU directives. A recompilation of the calling program is unnecessary; only a recollection is needed. For example, if the following call to the MFDSP$ routine were in a program, the common bank version of the MFDSP$ routine would be used. M$FDSP,'CB' PKTLENGTH,PKTADDR,FUNCCODE To force the program to use the relocatable version of the MFDSP$ routine, it would only be necessary to re-collect the program with the following Collector directives included: IN MFDSP$ EQU CBMFDSP$/MFDSP$ The Collector directive EQU forces the tag CBMFDSP$ to be evaluated as MFDSP$. An explicit inclusion of the element that contains the entry point MFDSP$ (in this case the element name is MFDSP$) is necessary to avoid errors during the collection. Appendix E lists the names of all the common banks and relocatable entry points and the names of the SYSLIB elements that include them. After the collection, the SYSLIB routine MFDSP$ is an integral part of the new absolute program. This adds about 1,000 words to the size of the absolute element. Programs that originally call the relocatable version of a SYSLIB routine, for example I$BJ X11,RFTI$ . BSP$, read file table index and that wish to call the common bank version of the routine need the following collector directives: IN CBEP$$SYSLIB EQU RFTI$/CBRFTI$ The Collector directive EQU forces the tag RFTI$ to be evaluated as CBRFTI$. The explicit inclusion of the element CBEP$$SYSLIB is necessary to resolve the reference to CBRFTI$. The element CBEP$$SYSLIB contains all the common bank entry point names and must be explicitly included in collections that use the EQU directive to switch from the relocatable version of a SYSLIB routine to the common bank version of the routine. 7833 1733–004 3–3
Page 1 and 2: OS 2200 System Service Routines Lib
Page 3: OS 2200 System Service Routines Lib
Page 6 and 7: Contents 4.2.5. Error Status Codes
Page 8 and 9: Contents 14.1.4. Reusable Processor
Page 10 and 11: Contents Section 19. SAR$ ATREAD ..
Page 12 and 13: Contents Section 23. SIR$-Symbolic
Page 14 and 15: Contents Appendix J. Obsolete Entry
Page 16 and 17: Figures xiv 7833 1733-004
Page 18 and 19: Tables 20-1. SAR$: PLUS COM Buffer
Page 20 and 21: Introduction 1.2. Notation Conventi
Page 22 and 23: Introduction Numbers are represente
Page 24 and 25: Introduction If you install SYSLIB
Page 26 and 27: System Standard Procedures and Defi
Page 38 and 39: SYSLIB Access Methods This type of
Page 40 and 41: SYSLIB Access Methods 3-6 7833 1733
Page 42 and 43: AEDIT$-ASCII Image Composition Edit
Page 68 and 69: BSP$-Program File Basic Service Pac
Page 86 and 87:
BSP$-Program File Basic Service Pac
Page 88 and 89:
Page 90 and 91:
Page 92 and 93:
Page 94 and 95:
Page 96 and 97:
Page 98 and 99:
Page 100 and 101:
Page 102 and 103:
Page 104 and 105:
Page 106 and 107:
CABSAD$, CRELAD$-Addressing Routine
Page 108 and 109:
Page 110 and 111:
Page 112 and 113:
Page 114 and 115:
Page 116 and 117:
Page 118 and 119:
Page 120 and 121:
CONWRD$-Condition Word Routine Para
Page 122 and 123:
CONWRD$-Condition Word Routine 7-4
Page 124 and 125:
EDIT$-Fieldata Image Composition Ed
Page 126 and 127:
Page 128 and 129:
Page 130 and 131:
Page 132 and 133:
Page 134 and 135:
FDASC$-Fieldata/ASCII Data Conversi
Page 136 and 137:
FDASC$-Fieldata/ASCII Data Conversi
Page 138 and 139:
GETPSF$-Get a Scratch File Routine
Page 140 and 141:
Page 142 and 143:
Page 144 and 145:
ID$-Identification Line Routine Exe
Page 146 and 147:
ID$-Identification Line Routine Bit
Page 148 and 149:
ID$-Identification Line Routine Err
Page 150 and 151:
ID$-Identification Line Routine 11.
Page 152 and 153:
ID$-Identification Line Routine Bit
Page 154 and 155:
ID$-Identification Line Routine 11.
Page 156 and 157:
ID$-Identification Line Routine err
Page 158 and 159:
INFOR$-Internal Format Table Interf
Page 160 and 161:
Page 162 and 163:
Page 164 and 165:
Page 166 and 167:
Page 168 and 169:
Page 170 and 171:
MFDSP$-Master File Directory Servic
Page 172 and 173:
Page 174 and 175:
Page 176 and 177:
Page 178 and 179:
Page 180 and 181:
Page 182 and 183:
PREPRM, PREPRO, PREPF$, and POSTPR$
Page 184 and 185:
Page 186 and 187:
Page 188 and 189:
Page 190 and 191:
Page 192 and 193:
Page 194 and 195:
Page 196 and 197:
ROR, ROR$-Relocatable Output Routin
Page 198 and 199:
Page 200 and 201:
Page 202 and 203:
Page 204 and 205:
SAR$-Symbolic Access Routines 16.1.
Page 206 and 207:
SAR$-Symbolic Access Routines FILE_
Page 208 and 209:
SAR$-Symbolic Access Routines NEXT_
Page 210 and 211:
SAR$-Symbolic Access Routines FIP$A
Page 212 and 213:
SAR$-Symbolic Access Routines FIP$H
Page 214 and 215:
SAR$-Symbolic Access Routines 16.2.
Page 216 and 217:
SAR$-Symbolic Access Routines 16-14
Page 218 and 219:
SAR$ READ 17.1.1.1. Required Inform
Page 220 and 221:
SAR$ READ REQUEST_TYPE PLUS Attribu
Page 222 and 223:
SAR$ READ READ_ADDRESS_WORD_OFFSET
Page 224 and 225:
SAR$ READ CHARACTER_CODE PLUS Attri
Page 226 and 227:
SAR$ READ CONTROL_RECORD_WORD_LENGT
Page 228 and 229:
SAR$ READ The default buffer and ta
Page 230 and 231:
SAR$ READ 17.1.3.2. SAR_READ Proced
Page 232 and 233:
SAR$ READ 17.1.3.4. Example The fol
Page 234 and 235:
SAR$ READ Table 17-3. SAR$: READ Pr
Page 236 and 237:
SAR$ READ 17.2. READ Function/MASM
Page 238 and 239:
SAR$ READ SR$REQTYPE The requested
Page 240 and 241:
SAR$ READ SR$CALLST The status code
Page 242 and 243:
SAR$ READ SR$SDFICW The image contr
Page 244 and 245:
SAR$ READ 17.2.3.1. Open-Input Proc
Page 246 and 247:
SAR$ READ 17.2.3.3. Close-Input Pro
Page 248 and 249:
SAR$ READ Table 17-6. SAR$: READ Pr
Page 250 and 251:
SAR$ READ 17.3.3. ASCII/ISO with Em
Page 252 and 253:
SAR$ WRITE The calling program must
Page 254 and 255:
SAR$ WRITE 18.1.1.2. Optional Infor
Page 256 and 257:
SAR$ WRITE OUTPUT_IMAGE_CHARACTER_T
Page 258 and 259:
SAR$ WRITE LINE_NUMBER_INTEGER_PART
Page 260 and 261:
SAR$ WRITE IMAGE_BYTE_LENGTH PLUS A
Page 262 and 263:
SAR$ WRITE The default buffer and t
Page 264 and 265:
SAR$ WRITE 18.1.3.2. SAR_WRITE Proc
Page 266 and 267:
SAR$ WRITE S'Print_heading' Insert
Page 268 and 269:
SAR$ WRITE 18.1.3.5. Example The fo
Page 270 and 271:
SAR$ WRITE Table 18-3. SAR$: WRITE
Page 272 and 273:
SAR$ WRITE Empty symbiont output fi
Page 274 and 275:
SAR$ WRITE SW$OUTRECT The type of r
Page 276 and 277:
SAR$ WRITE SW$ELTCDT For SDF elemen
Page 278 and 279:
SAR$ WRITE 18.2.1.4. WRITE Packet D
Page 280 and 281:
SAR$ WRITE • Optional parameters
Page 282 and 283:
SAR$ WRITE Initial Condition The ca
Page 284 and 285:
SAR$ WRITE Table 18-6. SAR$: WRITE
Page 286 and 287:
SAR$ WRITE 18-36 7833 1733-004
Page 288 and 289:
SAR$ ATREAD 19.1.1.1. Required Info
Page 290 and 291:
SAR$ ATREAD Other character set typ
Page 292 and 293:
SAR$ ATREAD OUTPUT_IMAGE_BYTE_LENGT
Page 294 and 295:
SAR$ ATREAD 19.1.3. ATREAD Procedur
Page 296 and 297:
SAR$ ATREAD • Attributes The addr
Page 298 and 299:
SAR$ ATREAD Table 19-3. SAR$: ATREA
Page 300 and 301:
SAR$ ATREAD SA$OTEXTB The address o
Page 302 and 303:
SAR$ ATREAD 19.2.1.3. Information R
Page 304 and 305:
SAR$ ATREAD 19.2.1.5. ATREAD Packet
Page 306 and 307:
SAR$ ATREAD • Optional parameters
Page 308 and 309:
SAR$ ATREAD S$ARATREAD does not spa
Page 310 and 311:
SAR$ ATREAD Table 19-6. SAR$: ATREA
Page 312 and 313:
SAR$ COM OUTPUT_TEXT_BUFFER_ADDRESS
Page 314 and 315:
SAR$ COM INPUT_SELECT_LIST_ADDRESS
Page 316 and 317:
SAR$ COM 20.1.1.3. Information Retu
Page 318 and 319:
SAR$ COM 20.1.3. SAR$ COM Procedure
Page 320 and 321:
SAR$ COM Table 20-3. SAR$: COM Proc
Page 322 and 323:
SAR$ COM 20.2.1.2. Optional Informa
Page 324 and 325:
SAR$ COM SC$RUNIDW1 The first four
Page 326 and 327:
SAR$ COM Example $ASCII $INCLUDE
Page 328 and 329:
SAR$ COM • Optional parameters (d
Page 330 and 331:
SAR$ COM Table 20-5. SAR$: COM Proc
Page 332 and 333:
SDFI, SDFO-System Data Format I/O R
Page 334 and 335:
Page 336 and 337:
Page 338 and 339:
Page 340 and 341:
Page 342 and 343:
Page 344 and 345:
Page 346 and 347:
Page 348 and 349:
Page 350 and 351:
SFDT$-System Standard Format Date a
Page 352 and 353:
Page 354 and 355:
Page 356 and 357:
Page 358 and 359:
Page 360 and 361:
Page 362 and 363:
SIR$-Symbolic Input/Output Routine
Page 364 and 365:
Page 366 and 367:
Page 368 and 369:
Page 370 and 371:
Page 372 and 373:
Page 374 and 375:
Page 376 and 377:
Page 378 and 379:
Page 380 and 381:
Page 382 and 383:
Page 384 and 385:
Program Trace Routine • The follo
Page 386 and 387:
Program Trace Routine Tracing can b
Page 388 and 389:
Program Trace Routine In each of th
Page 390 and 391:
Program Trace Routine In demand mod
Page 392 and 393:
Program Trace Routine CAPTUR Enters
Page 394 and 395:
Program Trace Routine T L B S E N D
Page 396 and 397:
Program Trace Routine LINE Adjusts
Page 398 and 399:
Program Trace Routine SET L N Print
Page 400 and 401:
Program Trace Routine 24.5. Control
Page 402 and 403:
Program Trace Routine 24-20 7833 17
Page 404 and 405:
SOR-Symbolic Output Routine SOR ins
Page 406 and 407:
SOR-Symbolic Output Routine 25.3. O
Page 408 and 409:
SOR-Symbolic Output Routine 25.5. E
Page 410 and 411:
Using SYSLIB A-2 7833 1733-004
Page 412 and 413:
Diagnostic Messages x FILE NOT AVAI
Page 414 and 415:
Diagnostic Messages SIR EDIT ERR c
Page 416 and 417:
Diagnostic Messages B-6 7833 1733-0
Page 418 and 419:
SYSLIB Restrictions C-2 7833 1733-0
Page 420 and 421:
SYSLIB Elements Table D-1. SYSLIB E
Page 422 and 423:
SYSLIB Elements Table D-1. SYSLIB E
Page 424 and 425:
SYSLIB Elements D-6 7833 1733-004
Page 426 and 427:
SYSLIB Common Bank Entry Points Tab
Page 428 and 429:
SYSLIB Common Bank Entry Points Tab
Page 430 and 431:
SYSLIB Common Bank Entry Points E-6
Page 432 and 433:
Interface to Selected Extended Mode
Page 434 and 435:
Page 436 and 437:
Page 438 and 439:
INFOR Information A field in the pr
Page 440 and 441:
INFOR Information Word 0 Bits 0-9 T
Page 442 and 443:
INFOR Information Bits 18-23 File C
Page 444 and 445:
INFOR Information G.4. INFOR Table
Page 446 and 447:
INFOR Information G-10 7833 1733-00
Page 448 and 449:
ASCII-like Character Sets Table H-1
Page 450 and 451:
ASCII-like Character Sets H-4 7833
Page 452 and 453:
Extended Mode Interface to SYSLIB I
Page 454 and 455:
Extended Mode Interface to SYSLIB T
Page 456 and 457:
Extended Mode Interface to SYSLIB b
Page 458 and 459:
Page 460 and 461:
Extended Mode Interface to SYSLIB P
Page 462 and 463:
Page 464 and 465:
Page 466 and 467:
Page 468 and 469:
Page 470 and 471:
Obsolete Entry Points, PROCs, and R
Page 472 and 473:
Page 474 and 475:
Page 476 and 477:
Page 478 and 479:
Page 480 and 481:
Page 482 and 483:
Page 484 and 485:
Page 486 and 487:
Page 488 and 489:
Page 490 and 491:
Related Product Information OS 1100
Page 492 and 493:
Glossary Exec The kernel of the OS
Page 494 and 495:
Glossary Problem list entry (PLE) A
Page 496 and 497:
Index Fieldata characters, 8-1 floa
Page 498:
Index read call, 21-8 SDFO close ca
show all

(SYSLIB) Programming Reference Manual - Public Support Login ...

Create successful ePaper yourself

Delete template?

Save as template?