Compaq OSI/APLMGR D43 manual

OSI/ FT AM Resp onde r Manual Abstract This manual des cribes the oper ation of the C o mpaq Open Systems Interconnection/File T ransfer, Acces s and M anagement (OSI/FT AM) responder and its virtual filestore (VFS). It is for programmers and users who ar e working with or writing remote FT AM applications that use the services of the Compaq respon[...]

Orderin g Information For manual orde ring i nformatio n: d omesti c U.S. customers, call 1-800-243- 6886; inte rnatio na l c ustome rs , c ontact you r lo ca l sa le s re pr e sen t a t i ve . Document Disclaimer Inform a t ion c o ntained in a manual is s u bje ct to change without n oti ce. Pl ease check with your au thorized repre s entat i ve [...]

Compaq Com puter Corporation — 425199-001 i OSI/ F T AM Responde r M anual Glossary Inde x Figure s Ta b l e s What’ s New in This Manual v Manual Informatio n v New and Changed Information v About This Manual vii Supported Standards viii Related Manuals ix Y our Comments Invited x Notation Convent ions xi 1. Introduction to th e Com paq F T AM[...]

Contents OSI/FT AM Respon der Manua l — 425199-00 1 ii 3. C ompaq FT AM Responde r Operation 3. Com p aq F T AM Re sponde r O p er ati on Responder St ructure 3-1 Responder Data Flow 3-2 4. Compaq FT AM Responder Suppor t of ISO F T AM Func tio ns Supported Functions 4-1 Service Classes 4-1 Functional Units 4-2 Attribute Groups 4-2 Attribute Supp[...]

Contents OSI/FT AM Respon der Manua l — 425199-00 1 iii 6. Respo nder Man ager 6. Responde r Mana ger Notes on Configuration 6-1 OSI Address of Responder 6-1 Initiator-Identity and Filestore-P assword Para meters 6-2 Protocol-Error Cou nter 6-2 Increasing Respond er Capacity 6-2 Increasing Respond er Performanc e 6-2 Fault T olerance 6-2 Event Me[...]

Contents OSI/FT AM Respon der Manua l — 425199-00 1 iv T abl es (continued) Ta b l e s (contin ued) T a ble 4-7. Select-Open Mappings: Compaq File S tructure to FT AM Contents T ype 4-8 T a ble 4-8. Actions Permitt ed for FT AM Document T yp e 4-12 T a ble 4-9. Simplification of Document T ypes Supported by the Compaq FT AM Responder 4-13 T able [...]

OSI/FT AM Respon der Manua l — 425199-00 1 v Wh at ’ s New in This Manual Manual Inf ormation Abstract This manual describes the operation of the Compaq Open Systems Interconnection/File T ransfer , Access and M anagement (OSI/FT AM) respond er and its virtual filestore (VFS). It is for programmers an d users who are working with or writing rem[...]

What’s New i n This Manual OSI/FT AM Respon der Manua l — 425199-00 1 vi New and Changed Inform ation[...]

OSI/FT AM Respon der Manua l — 425199-00 1 vii About This Manual The OS I/FT AM Res ponder Man ual provides instruction s and reference information needed to write application programs, or to u se interactive applications , that use the services of the Compaq OSI/File T ransfer , Access and Management (FT AM) responder process. This manual has th[...]

About T his Manu al OSI/FT AM Respon der Manua l — 425199-00 1 viii Supported S tandards Supporte d S tandar ds This manual and the other Com paq FT AM manuals are written on the assum ption that you are familiar with the ISO standards and t he National Institute of Standards an d T echnology (NIST) FT AM Phase 2 agreements to which Compaq FT AM [...]

About T his Manu al OSI/FT AM Respon der Manua l — 425199-00 1 ix Related M anu als Relat e d Manuals This manual is one in a set of Compaq FT AM manuals. • OSI/FT AM Pr ogramming Gui de . This manual explains important programming concepts pertaining to the Compaq FT AM application programmatic interface and describes sequences of procedure ca[...]

About T his Manu al OSI/FT AM Respon der Manua l — 425199-00 1 x Y our Comments Invite d If you are diagnosing and solvi ng FT AM problems using tools on the Co mpaq system where your responde r resides, you also need to refer to the following manuals: the OSI/FT AM Configuration and Management Manual and the SCF Refer ence Manual for FT AM and A[...]

About T his Manu al OSI/FT AM Respon der Manua l — 425199-00 1 xi Notation Conv entions Notati on Conventi ons Genera l Synt ax Nota tio n The following lis t summarize s the notation conventions for syntax presentation in this manual. UPPERCASE LETTERS. Uppercase letters indicate keywords and reserved words; enter these items exactly as shown. I[...]

About T his Manu al OSI/FT AM Respon der Manua l — 425199-00 1 xii General Sy ntax Notat ion An ellipsis imm ediately follo wing a single syntax it em indicates that you can repeat that syntax item any number of tim es. For example: " s-char ..." Punctuation. Parentheses, commas, semicolons, and other symbols not previ ously described m[...]

About T his Manu al OSI/FT AM Respon der Manua l — 425199-00 1 xiii Notation f o r Messages !o:i. In procedure calls, th e !o:i notation follows an output buffer parameter that has a corresponding input parameter s pecifying the maximum length of th e output buffer in bytes. For example: error := FILE_GETINFO_ ( filenum !i , [ filename:maxlen ] )[...]

About T his Manu al OSI/FT AM Respon der Manua l — 425199-00 1 xiv Notation f or M anagem ent Programm ing Interfaces either vertically , with aligned braces on each side of the list, or horizontally , enclosed in a pair of braces and separated by vertical lines. For example: obj-type obj-name state changed to state , caused by { Object | Operato[...]

OSI/FT AM Respon der Manua l — 425199-00 1 1- 1 1 Intr oduction to the Co mpaq FT AM Responder This manual descri bes the Compaq Open Systems Inter connection/File T ransfer , Access and Management (O SI/FT A M) responder and its virtual filest ore ( VFS ). Compaq OSI/FT AM is the Compaq implementation of th e FT AM standard ISO 8571, developed b[...]

Introduction to the Com paq F T A M Respond er OSI/FT AM Respon der Manua l — 425199-00 1 1-2 Comp aq FT AM Servi ce s FT AM users communicate with the FT AM service provider by way of primitives , the smallest units of interaction between the FT AM user and the FT AM service provider . An operation like any of those men tioned above requires the[...]

Introduction to the Com paq F T A M Respond er OSI/FT AM Respon der Manua l — 425199-00 1 1-3 FT AM A pplications responder , you use the standard FT AM file-handling conventions to perform remote file- handling tasks, by means of the FT AM interface on your remote system. Each FT AM service, or file o peration, requires that m ultiple FT AM prot[...]

Introduction to the Com paq F T A M Respond er OSI/FT AM Respon der Manua l — 425199-00 1 1-4 Mana gem ent Interfaces Man a geme nt In t erf ace s For those people with access to the Compaq system wh o are responsible for confi guring and managing FT AM responder processes and for solving FT AM problems, Compaq FT AM suppo rts the Distributed Sys[...]

Introduction to the Com paq F T A M Respond er OSI/FT AM Respon der Manua l — 425199-00 1 1-5 The Respon der and U nderlying Subsystems • Compaq application, presentation, and session service p rovider ( TA P S ) processes perform the services of the Association Control Service E lement ( ACS E ) in the Application Layer, plus the services of t[...]

Introduction to the Com paq F T A M Respond er OSI/FT AM Respon der Manua l — 425199-00 1 1-6 The Respon der and U nderlying Subsystems PDUs from a remote FT AM initiator are received by the Compaq system at the Physical Layer and are transmitted up thro ugh the appropriate communications controller (or adapter), NSP process, TSP process, and T A[...]

Introduction to the Com paq F T A M Respond er OSI/FT AM Respon der Manua l — 425199-00 1 1-7 The Responder and th e File System The R esponder a nd the File Syste m Figure 1-2 also shows the file system used by the Compaq responder to access files. When a remote FT AM init iator requests access to fil es, the Com paq FT AM responder provides tha[...]

Introduction to the Com paq F T A M Respond er OSI/FT AM Respon der Manua l — 425199-00 1 1-8 The Responder and th e File System[...]

OSI/FT AM Respon der Manua l — 4 25199-00 1 2-1 2 Conformance and Inter operatilit y This section presen ts informati on about the conformance to standards and the interoperability of the Compaq FT AM responder . Conformance is t he satisfactio n of the requi rements of the applicable standards, consistent with th e capabilitie s stated in the pr[...]

Conforma nce an d I nteroperat ility OSI/FT AM Respon der Manua l — 4 25199-00 1 2-2 Basic Charact eristics of FT AM Impl eme ntations When evaluating in teroperability between Co mpaq FT AM and an other FT AM implementation, consider the following aspects in whi ch FT AM implementations can vary . Section 4 of this manual provides yo u with addi[...]

Conforma nce an d I nteroperat ility OSI/FT AM Respon der Manua l — 4 25199-00 1 2-3 Limitations on V alue of Future-Filesize Attribute Attribut es Aspects of attribut es that can affect interoperab ility include the optional groups of attributes, the level of support for each indiv idual attribute (see T able 4-4) and its optional components, an[...]

Conforma nce an d I nteroperat ility OSI/FT AM Respon der Manua l — 4 25199-00 1 2-4 Data-T ransfer Consi derations Maxi mum -S tr ing -Le ngth Par ame te r Compaq FT AM supports unbounded strings. The limitations of the maximum-string- length parameter are described in d etail in Section 4. S tring-S ignifica nce Param eter The Compaq FT AM resp[...]

Conforma nce an d I nteroperat ility OSI/FT AM Respon der Manua l — 4 25199-00 1 2-5 Data-T ransfer Consi derations Limi ts on Smal l S tring -Le ngth V alu e s With Larg e PD Us When the Compaq FT AM responder receives data from a remote initiato r , it decodes the data and stores it, as a sequence of strings, in an internal buffer with a maximu[...]

Conforma nce an d I nteroperat ility OSI/FT AM Respon der Manua l — 4 25199-00 1 2-6 Presentation Encoding of FT AM P DUs and D ata For FT AM-3 files, keep in mind that the native character sets (ASCII, EBCDIC, and so on) might be incompatible on the sending and receiv ing system s. For example, Compaq systems use the 7-bit ASCII chara cter set, [...]

Conforma nce an d I nteroperat ility OSI/FT AM Respon der Manua l — 4 25199-00 1 2-7 Presentation Encoding of FT AM P DUs and D ata When receiving PD Us, Compaq FT AM supports all three optio ns listed above. When sending PDUs, Compaq FT AM follows these rules: • If single FT AM PDUs a re to be sent, they are placed in a single PDV list encoded[...]

Conforma nce an d I nteroperat ility OSI/FT AM Respon der Manua l — 4 25199-00 1 2-8 Presentation Encoding of FT AM P DUs and D ata[...]

OSI/FT AM Respon der Manua l — 425199-00 1 3-1 3 Com p a q FT AM Responder Operation The Compaq respo nder receives an FT AM request from an initiating system, processes it, performs the appr opriate action, and returns an FT A M response to the initi ating system. It performs file-handli ng operation s through its virtual file store (VFS), which[...]

Compaq F T AM Responder O peration OSI/FT AM Respon der Manua l — 425199-00 1 3-2 Responde r Data F l ow Responder Data Flow Protocol and user data generally flows to and from the Compaq responder in the steps described below . Note that the responder sends primarily responses, although cancel and abort requests—and data indications during a da[...]

Compaq F T AM Responder O peration OSI/FT AM Respon der Manua l — 425199-00 1 3-3 Responde r Data F l ow 2. The FT AM in itiator follows the OSI protocol esta blished on the initiating system to send the outgoing FT AM protocol data unit (PDU) over the net work to the Compaq responding system, where it is received as an indication. 3. Once on the[...]

Compaq F T AM Responder O peration OSI/FT AM Respon der Manua l — 425199-00 1 3-4 Responde r Data F l ow[...]

OSI/FT AM Respon der Manua l — 425199-00 1 4-1 4 Compaq FT AM Responder Support of ISO FT A M Functions This section provides detailed information on the Compaq FT A M responder ’ s support of ISO FT AM functions. It includes the following information: • FT AM functions supported by the Compaq responder • V irtual filestore (VFS) mapping co[...]

Compaq FT A M Respond er Suppo rt of ISO F T A M Fu n cti o ns OSI/FT AM Respon der Manua l — 425199-00 1 4-2 Functional Units Fu ncti ona l Unit s T a ble 4-2 iden tifies the FT AM fun ctional uni ts that the C ompaq respo nder process supports. The Compaq respon der supports all ISO-defined functional units excep t the F ADU locking, recovery ,[...]

Compaq FT A M Respond er Suppo rt of ISO F T A M Fu n cti o ns OSI/FT AM Respon der Manua l — 425199-00 1 4-3 Attribute Support responder partially supports an attribute, it recognizes the attribute name as valid, but provides no value for it. In this case, any refer ence to that a ttribute yields the result that no value is available, and any at[...]

Compaq FT A M Respond er Suppo rt of ISO F T A M Fu n cti o ns OSI/FT AM Respon der Manua l — 425199-00 1 4-4 Docu ment T ypes * In this cont e xt , ful l s u pport applies to th e contents type as a wh ole; it does no t im ply t he s upport o f all documen t type s or all possible values of the parameters (maxim um-stri ng-l ength, universal- cl[...]

Compaq FT A M Respond er Suppo rt of ISO F T A M Fu n cti o ns OSI/FT AM Respon der Manua l — 425199-00 1 4-5 Mappi ng Between FT AM Contents T ypes and Compaq F ile S tructures FTAM-2 files are rela tive (s e quent ial) files, and ea c h l ogical r ecord of a relat ive file can be a maxim um of 407 2 byte s. Each strin g is stored as a logi cal [...]

Compaq FT A M Respond er Suppo rt of ISO F T A M Fu n cti o ns OSI/FT AM Respon der Manua l — 425199-00 1 4-6 Create Mappi ngs fall within the range supported by the Compaq responder for that document type a nd string-significance value, as follows: If the maximum-string-length parameter is not specified or if the specified value does not fall wi[...]

Compaq FT A M Respond er Suppo rt of ISO F T A M Fu n cti o ns OSI/FT AM Respon der Manua l — 425199-00 1 4-7 Sele ct-Open Mappi ngs ∗ The follo wing value s a re pos s ible for file ty pe: U = E ns cr i be un st r uctu r e d R = Ens cri be rela tive E = Enscribe entr y-sequenced ∗∗ This is th e stan da rd Guardia n fil e attribut e that st[...]

Compaq FT A M Respond er Suppo rt of ISO F T A M Fu n cti o ns OSI/FT AM Respon der Manua l — 425199-00 1 4-8 Sele ct-Open Mappi ngs When you issue a fi le-open reque st, you speci fy a contents-type parameter that provides the document type of the file and, optionall y , parameter values that fur ther define the document type. W hen a remote ini[...]

Compaq FT A M Respond er Suppo rt of ISO F T A M Fu n cti o ns OSI/FT AM Respon der Manua l — 425199-00 1 4-9 Sele ct-Open Mappi ngs Fi xe d-length bina ry file E8 9 1 F T A M - 3 maximum-s tring-lengt h = record le ngth** string-s i gnifica nc e = f ixed Va r i a b l e - leng th binary file E8 9 2 F T A M - 3 maximum-s tring-lengt h = record le [...]

Compaq FT A M Respond er Suppo rt of ISO F T A M Fu n cti o ns OSI/FT AM Respon der Manua l — 425199-00 1 4- 1 0 Maxim um-S tring-Length Checking o f Data V alues Maximum -S tring-Length Che cking of Da ta V alues The responder enforce s strict rules on maximum-string-length checking. Every data value received or sent by the responder is checked [...]

Compaq FT A M Respond er Suppo rt of ISO F T A M Fu n cti o ns OSI/FT AM Respon der Manua l — 425199-00 1 4- 1 1 File-Attribute M appings strings may require you to increase the value of the maximum-string-length parameter in your requests. The following formula defines the conditions under which decoded data will fit into the b uffer: NS-1 Σ (([...]

Compaq FT A M Respond er Suppo rt of ISO F T A M Fu n cti o ns OSI/FT AM Respon der Manua l — 425199-00 1 4- 1 2 Kernel Grou p File Attributes Filename Attribute The filename attribu te maps directly from the Compaq external file name to the F T AM VFS, with the ex ception of specifying NBS-9 files. For an explanation of the relationship between [...]

Compaq FT A M Respond er Suppo rt of ISO F T A M Fu n cti o ns OSI/FT AM Respon der Manua l — 425199-00 1 4- 1 3 Kernel Grou p File Attributes The responder allow s for the simplification of FT AM-2 document types to FT AM-1 document types on ly . In addit ion, FT AM-2 simplification is allowed only on Compaq Enscribe relative files, not on SQL t[...]

Compaq FT A M Respond er Suppo rt of ISO F T A M Fu n cti o ns OSI/FT AM Respon der Manua l — 425199-00 1 4- 1 4 Kernel Grou p File Attributes Y ou can specify DIRLIS with volume or subvolume in any of the following ways: • $ volume . subvol .DIRLIS • $ volume .DIRLIS • subvol .DIRLIS • DIRLIS Each NBS-9 docum ent has an at tributes bit-s[...]

Compaq FT A M Respond er Suppo rt of ISO F T A M Fu n cti o ns OSI/FT AM Respon der Manua l — 425199-00 1 4- 1 5 S torage Group File Attributes request primitive. This allow s you to spe cify all or a subset of the attributes listed above. (Likewise, to control wh ich attributes the responder returns wh en you read th e attributes of an NBS-9 fil[...]

Compaq FT A M Respond er Suppo rt of ISO F T A M Fu n cti o ns OSI/FT AM Respon der Manua l — 425199-00 1 4- 1 6 S torage Group File Attributes filesize parameter is not specified in a create request, the resp onder creates a file with a future-filesize value of 8 MB. Subsequent change-attribute requests can change the value o f max-extents. In a[...]

Compaq FT A M Respond er Suppo rt of ISO F T A M Fu n cti o ns OSI/FT AM Respon der Manua l — 425199-00 1 4- 1 7 Security Group File Attributes Security Group File Attributes The remote respond er and local initiator nego tiate security attributes. The responder fully supports som e security attributes while only part ially suppo rting others. If[...]

Compaq FT A M Respond er Suppo rt of ISO F T A M Fu n cti o ns OSI/FT AM Respon der Manua l — 425199-00 1 4- 1 8 Security Group File Attributes which access to a fil e is allowed. ISO 8571-2 provides a complete description of the ISO FT AM access-control attribute. W ithin th e access-control attribute, the Compaq responder uses only the action-l[...]

Compaq FT A M Respond er Suppo rt of ISO F T A M Fu n cti o ns OSI/FT AM Respon der Manua l — 425199-00 1 4- 1 9 Security Group File Attributes If the access-control attribute is n ot present in the F-CRE A TE indicat ion, the Compaq responder sets Compaq file security to the default security allowed for the FT A M association, as defined by the [...]

Compaq FT A M Respond er Suppo rt of ISO F T A M Fu n cti o ns OSI/FT AM Respon der Manua l — 425199-00 1 4- 2 0 Security Group File Attributes • If any of the insert, replace, extend, change-attribute, or erase a ccess-control bits of the action list are set, the responder sets WRITE access to N, indicating that any user on the Expand network [...]

Compaq FT A M Respond er Suppo rt of ISO F T A M Fu n cti o ns OSI/FT AM Respon der Manua l — 425199-00 1 4- 2 1 Private Group File Attributes The read-attribute bi t is always se t. Legal -Q ual if icati ons Attr ibut e The legal-qualifications attribute conveys information about the legal status of the file and its use. This attribute is partia[...]

Compaq FT A M Respond er Suppo rt of ISO F T A M Fu n cti o ns OSI/FT AM Respon der Manua l — 425199-00 1 4- 2 2 File-Acces s and Security Consi derations T a ble 4-16 shows which optional parameters the Co mpaq responder can return in a response PDU. File -Access and Security Consid eratio ns The VFS controls access to file s through normal Guar[...]

Compaq FT A M Respond er Suppo rt of ISO F T A M Fu n cti o ns OSI/FT AM Respon der Manua l — 425199-00 1 4- 2 3 File-Acces s and Security Consi derations password. For deta ils on configuring a defau lt user , refer to the OSI/FT AM Configuration and Management Manual . The VFS actions allowed by t he FT AM responder d epend on the Guardian sec [...]

Compaq FT A M Respond er Suppo rt of ISO F T A M Fu n cti o ns OSI/FT AM Respon der Manua l — 425199-00 1 4- 2 4 File-Acces s and Security Consi derations actions are open for E XCLUSIVE access; only one user at a time can open a file for writing. Where a combination of VFS actions are performed on a file, that file’ s exclusion mode is EXCLUSI[...]

OSI/FT AM Respon der Manua l — 425199-00 1 5-1 5 Suggesti ons for Developm ent o f Remote Applic ations When you write an FT AM application that uses the services of th e Compaq responder , how you design, code, and debug it depends largely on the interface you are using on the remote system. H owever , there are some general things you should co[...]

Suggest ions for Dev elopm ent of Rem ote Applications OSI/FT AM Respon der Manua l — 425199-00 1 5-2 T r oubleshooting The Compaq FT AM responder returns diagnostic m essages to your application as specified by the ISO 8 571 standard. In many cases, more information is returned than is required by the standard. Appendix A, “Compaq FT AM Respon[...]

Suggest ions for Dev elopm ent of Rem ote Applications OSI/FT AM Respon der Manua l — 425199-00 1 5-3 T r oubleshooting The Compaq prob lem solver can use SCF commands to display configuration, status, and statistics info rmation abo ut the responder and APL MGR proces ses on the C ompaq system. This information can sometimes provide clues to the[...]

Suggest ions for Dev elopm ent of Rem ote Applications OSI/FT AM Respon der Manua l — 425199-00 1 5-4 T r oubleshooting[...]

OSI/FT AM Respon der Manua l — 425199-00 1 6-1 6 Responder Manager This section discu sses conside rations that are related to the configuration and management of the responder process and its VFS on the Compaq system, but that you might need to know when writ ing or using FT AM applications on the rem ote system. It covers the followin g topics:[...]

Responde r Manager OSI/FT AM Respon der Manua l — 425199-00 1 6-2 Initiator-Identity and Filestore-Password Parameters Initiator -Identity and Filestore-Password Param eter s The initiator-identity and filesto re-password p arameters in the F-INITIALIZE request correspond, respectiv ely , to the Guardian user ID and password on the C ompaq system[...]

Responde r Manager OSI/FT AM Respon der Manua l — 425199-00 1 6-3 Event Mes sages If the Compaq FT AM resp onder process is running as a NonStop process pai r , the backup Compaq FT AM responder process takes over , and your remote application must reinitiate its Com paq FT AM associations. Y ou or your application sho uld then check and verify a[...]

Responde r Manager OSI/FT AM Respon der Manua l — 425199-00 1 6-4 Event Mes sages • Failure to establish an associat ion with a C ompaq resp onder due to an invalid initiator ID or pass word • Compaq responder virtual filestore (VFS) file-access failu res due to file-system errors or security violations The responder also returns an even t me[...]

OSI/FT AM Respon der Manua l — 4 25199-00 1 A-1 A Com paq FT AM Responder Diagnostic Me ssage s The Compaq FT AM responder diagnostic messages can be returned in indicat ions and confirms to an initiating FT AM implementation that requested the Compaq FT A M responder to execute a service that it cannot perform. They can also be returned to provi[...]

Compaq FT A M Res ponder Diagnost ic Messages OSI/FT AM Respon der Manua l — 4 25199-00 1 A-2 General F T AM Diagnostic Messages The detailed descrip tions of the diagnostic messages tha t follow each summary ta ble are also listed numerically by the error identifie r . In addition to the information provided in this appendix, responder diagnosti[...]

Compaq FT A M Res ponder Diagnost ic Messages OSI/FT AM Respon der Manua l — 4 25199-00 1 A-3 General F T AM Diagnostic Messages Effect. The responder aborts the a ssociation. If the data buffer capacity was exceeded for the reason given under “Cause ,” the Further Details field contains th e message smaller PDU or lar ger MSL needed. Recover[...]

Compaq FT A M Res ponder Diagnost ic Messages OSI/FT AM Respon der Manua l — 4 25199-00 1 A-4 Protoc ol and Support ing Service-Related D iagnostic Mess ages Recovery . The appl ication or FT AM us er should retry the operati on. This can be a transient condition. If the condition persists, the Compaq problem solver can start another FT AM respon[...]

Compaq FT A M Res ponder Diagnost ic Messages OSI/FT AM Respon der Manua l — 4 25199-00 1 A-5 Protoc ol and Support ing Service-Related D iagnostic Mess ages 1001 Cause. A request contained a p arameter value that the Com paq FT AM responder did not support: for ex ample, the o verride param eter did not equal one of the values supported by the C[...]

Compaq FT A M Res ponder Diagnost ic Messages OSI/FT AM Respon der Manua l — 4 25199-00 1 A-6 Protoc ol and Support ing Service-Related D iagnostic Mess ages 1009 Cause. The responder received a s ervice request that requires a functional unit that wa s not negotiated whe n the association was established. Effect . The responder rejects the reque[...]

Compaq FT A M Res ponder Diagnost ic Messages OSI/FT AM Respon der Manua l — 4 25199-00 1 A-7 Assoc iation-Related Diagnos tic Mess ages access is less than the number of services in the group. (O nly the file-access service class allows a threshold of less than the num ber of services in the group, allowing a group of primitiv es to provide some[...]

Compaq FT A M Res ponder Diagnost ic Messages OSI/FT AM Respon der Manua l — 4 25199-00 1 A-8 Assoc iation-Related Diagnos tic Mess ages 2002 Cause. The responder received an initialize request for the unconstrained service class. The Compaq FT AM implementation does not su pport the unconstrained service class. Effect. The association is not es [...]

Compaq FT A M Res ponder Diagnost ic Messages OSI/FT AM Respon der Manua l — 4 25199-00 1 A-9 Assoc iation-Related Diagnos tic Mess ages 2015 Cause. The initiator-identity parameter in the initialize re quest was invalid, or it w as omitted and there was no defaul t user ID/password configured for the responder . Effect. The association is not es[...]

Compaq FT A M Res ponder Diagnost ic Messages OSI/FT AM Respon der Manua l — 4 25199-00 1 A- 1 0 Selection-Related Diagnostic M essages Effect. The association is not es tablished. The responder generates the password-fail event (event numbe r 20). Recovery . For the first cause, the application or FT AM user should retry the r equest using a val[...]

Compaq FT A M Res ponder Diagnost ic Messages OSI/FT AM Respon der Manua l — 4 25199-00 1 A- 1 1 Selection-Related Diagnostic M essages 3000 Cause. The file requested on the select service could not be found. File-system error 1 1 was returned. Effect. The service fails. Recovery . The appl ication or FT AM us er should try again usin g a correct[...]

Compaq FT A M Res ponder Diagnost ic Messages OSI/FT AM Respon der Manua l — 4 25199-00 1 A- 1 2 Selection-Related Diagnostic M essages Effect. The service fails. Recovery . The application program mer or FT AM user should check the attribute values and determine whic h attribute the responder does not support, and then retry the request without [...]

Compaq FT A M Res ponder Diagnost ic Messages OSI/FT AM Respon der Manua l — 4 25199-00 1 A- 1 3 Selection-Related Diagnostic M essages 3007 Cause. The application or FT AM user attempted to delete a directory list (N BS-9), or the PURGE proced ure has failed. Effect. The file is n ot deleted. The Further D etails field identifies the related fil[...]

Compaq FT A M Res ponder Diagnost ic Messages OSI/FT AM Respon der Manua l — 4 25199-00 1 A- 1 4 Selection-Related Diagnostic M essages 3018 Cause. The application or FT AM user attempted to create a file with a future-filesize value greater than one gigabyte. T he Compaq FT AM responder do es not support files larger than one gigabyte. Effect. T[...]

Compaq FT A M Res ponder Diagnost ic Messages OSI/FT AM Respon der Manua l — 4 25199-00 1 A- 1 5 Selection-Related Diagnostic M essages 3027 Cause. An invalid value was d etected in an attribute on the create or select service. This message is caused if the filename attribute cannot be decoded or is invalid for the file system. Effect. The servic[...]

Compaq FT A M Res ponder Diagnost ic Messages OSI/FT AM Respon der Manua l — 4 25199-00 1 A- 1 6 File-Manage ment-Related Dia gnostic M essages Effect. The file is cr eated, but not selected. The state-result parameter of the create confirm returns a failure indication. Recovery . The application or FT AM user should issue a select request specif[...]

Compaq FT A M Res ponder Diagnost ic Messages OSI/FT AM Respon der Manua l — 4 25199-00 1 A- 1 7 Access-Rela te d Diagnos tic Mes sages 4003 Cause. Either a read-attribute request including the priva te attributes was issued, or an attempt was made to change an attribute that cannot be changed. Compaq FT A M does not support privat e attributes. [...]

Compaq FT A M Res ponder Diagnost ic Messages OSI/FT AM Respon der Manua l — 4 25199-00 1 A- 1 8 Access-Rela te d Diagnos tic Mes sages 5000 Cause. The F ADU -ID parameter on a read or w rite request is invalid. Effect. The responder cancels the s ervice, and th e association is left in a d ata-transfer idle state. Recovery . The appl ication or [...]

Compaq FT A M Res ponder Diagnost ic Messages OSI/FT AM Respon der Manua l — 4 25199-00 1 A- 1 9 Access-Rela te d Diagnos tic Mes sages 5001 Cause. The application or FT AM user tried to acces s a nonexistent column i n an SQL table. Effect. The responder cancels the s ervice, and th e association is left in a d ata-transfer idle state. Recovery [...]

Compaq FT A M Res ponder Diagnost ic Messages OSI/FT AM Respon der Manua l — 4 25199-00 1 A- 2 0 Access-Rela te d Diagnos tic Mes sages 5005 Cause. The responder received a r ead or erase request for an em pty FT AM-2 relative file. Effect. In the case of a read, the resp onder cancels the service. In the case of an erase, the responder issues a [...]

Compaq FT A M Res ponder Diagnost ic Messages OSI/FT AM Respon der Manua l — 4 25199-00 1 A- 2 1 Access-Rela te d Diagnos tic Mes sages 5015 Cause. Either the VFS has at tempted to open a file, but the operating system OPEN procedure has failed, or a write request has been issued with out the F ADU operation set to insert, replace, or extend. Eff[...]

Compaq FT A M Res ponder Diagnost ic Messages OSI/FT AM Respon der Manua l — 4 25199-00 1 A- 2 2 Access-Rela te d Diagnos tic Mes sages Effect. The responder cancels the s ervice, and th e association is left in a d ata-transfer idle state. Recovery . The appl ication or FT AM us er should issue a cancel response and then reissue the read request[...]

Compaq FT A M Res ponder Diagnost ic Messages OSI/FT AM Respon der Manua l — 4 25199-00 1 A- 2 3 Access-Rela te d Diagnos tic Mes sages file recovery operations normally used at the site; then the application or FT AM user can retry the application . 5028 Cause. A local file-system error occurred as a result of one of the following actions: • F[...]

Compaq FT A M Res ponder Diagnost ic Messages OSI/FT AM Respon der Manua l — 4 25199-00 1 A- 2 4 Access-Rela te d Diagnos tic Mes sages Recovery . The appl ication or FT AM us er should send a cancel response, close the file, and use the change-attribute service to increase the value of the future-filesize attribute of the file. 5036 Cause. A ser[...]

Compaq FT A M Res ponder Diagnost ic Messages OSI/FT AM Respon der Manua l — 4 25199-00 1 A- 2 5 Recovery-Rela ted Diagnostic M essages 5040 Cause. The Compaq FT AM responder received a request with a F ADU-lock parameter on a read or write service. The Co mpaq FT AM responder does not support the F ADU- lock parameter . Effect. The responder can[...]

Compaq FT A M Res ponder Diagnost ic Messages OSI/FT AM Respon der Manua l — 4 25199-00 1 A- 2 6 Recovery-Rela ted Diagnostic M essages[...]

OSI/FT AM Respon der Manua l — 425199-00 1 Glossa ry - 1 Glo ssary The following glo ssary defines terms used b oth in this manual and in the other Compaq FT AM manua ls. Not all terms listed here are used in this particular manual. abstract syntax. A stan dardized met hod of describing data st ructures that is independent of the way they are rep[...]

Glossary OSI/FT AM Respon der Manua l — 425199-00 1 Glossa ry - 2 (Application Layer) to manipul ate files on remote compu ter systems. For Compaq FT AM, applications can be written in C or T A L. application entity . The part of an application process that interacts with its peer entity in a remote application process. In an OSI ap plication, th[...]

Glossary OSI/FT AM Respon der Manua l — 425199-00 1 Glossa ry - 3 ASN.1 (Abstract Syntax Notation-1). The type and value syntax or notation language for representing sem antics of protocol that is described in ISO 8824. The Basic Encoding Rules (ISO 8825) standard defines a set of encoding rules that can be applied to values of types defined usin[...]

Glossary OSI/FT AM Respon der Manua l — 425199-00 1 Glossa ry - 4 code file. A Guardian file containing the object code that you must ru n to create th e specified process. collector An EMS process tha t accepts event messages fro m subsystems and logs them in the event log. See EMS. Compar e distributor . command file. A text file containing a s[...]

Glossary OSI/FT AM Respon der Manua l — 425199-00 1 Glossa ry - 5 protocol implementation conformance statement (PICS). S tatic conformance requirements are con straints speci fied in the s tandards or related profiles to facilitate interworking. Dynamic conformance requirements determine what obs ervable behavior is permitted by the standards o [...]

Glossary OSI/FT AM Respon der Manua l — 425199-00 1 Glossa ry - 6 (FUP) commands, and generates object-definition source code in a variety of programming languages. default user (DEFUSER). An attribute of a Compa q virtual filestore (VFS) profile that allows access to files in the Compaq responder ’ s VFS i n cases where the initiato r identity[...]

Glossary OSI/FT AM Respon der Manua l — 425199-00 1 Glossa ry - 7 Enscribe. The C ompaq database file-manag ement softw are provided as part of the Guardian file system . The Enscribe software p rovides access to—and manipulation of—records in a database on a Compaq system. Files on a Compaq NonStop system can be either Enscribe files or NonS[...]

Glossary OSI/FT AM Respon der Manua l — 425199-00 1 Glossa ry - 8 occurrence of a condition that mi ght af fect its operation. Event messages are collected centrally and distri buted to files, processes, and terminal s that are programmed to receive them. They are displayed in text form as operator messages. execution priority . A numeric-valued [...]

Glossary OSI/FT AM Respon der Manua l — 425199-00 1 Glossa ry - 9 encountered in access ing the file on the demountable device. The attrib ute value is s et when a file is created . file-management service class. A service class that perm its control of the virtual filestore through a series of inde pendent confirmed service exchanges, bu t does [...]

Glossary OSI/FT AM Respon der Manua l — 425199-00 1 Glo ssary - 10 first-level data types. Th e lowest-leve l DDL structures, which serve as build ing blocks on which DDL parameter structures are based. format effectors. A class of con trol characters mainly intended for layout and positioning of in formation o n character-imaging devices, s uch [...]

Glossary OSI/FT AM Respon der Manua l — 425199-00 1 Glo ssary - 1 1 Compaq max-extents attribute: modifying the future-filesize attribute changes th e max- extents attribute, and vice versa. GeneralS tring. The charact er -string type of strings containing any of the characters for all G sets and all C sets (as defined by ISO 2022), the space cha[...]

Glossary OSI/FT AM Respon der Manua l — 425199-00 1 Glo ssary - 12 • There are no restrictio ns on the number of levels, on the arc lengths, or on the number of arcs origi nating from each node. The access unit, or subtree, of a node in this m odel is called a file-access data unit (F ADU). FT AM-2 files have a two-level hierarchy of o ne root [...]

Glossary OSI/FT AM Respon der Manua l — 425199-00 1 Glo ssary - 13 internal process name. The name by which APLMGR recognizes a Compaq initiator or responder process. T his name is assigned wh en the process is created and can be a maximum of eigh t ASCII characters. International Organization for S tandardization. See ISO. International S tandar[...]

Glossary OSI/FT AM Respon der Manua l — 425199-00 1 Glo ssary - 14 management interface. An interface availab le to the sy stem manage r for use in configuring, monitoring, and controlling subsystems and relationships betwee n subsystems. Manager process. A Compaq subsystem process with which the Subsystem Control Point (SCP) ma nagement pro cess[...]

Glossary OSI/FT AM Respon der Manua l — 425199-00 1 Glo ssary - 15 Network service ac cess point. See NSAP . network service provider . See NSP . NIST (National Institute of Science and T echnology). A U.S. governmen t instituti on, formerly known as the National Bureau of Standards (NBS), that sets standards and promotes their acceptance. node. [...]

Glossary OSI/FT AM Respon der Manua l — 425199-00 1 Glo ssary - 16 object identifier . A value, dis tinguishable from all other such valu es, that is associated with an ISO inform ation object. A standard representation o f an object identifier is a set of numbers represent ing a directed path through a standards-based tree hierarchy , often show[...]

Glossary OSI/FT AM Respon der Manua l — 425199-00 1 Glo ssary - 17 OSI Reference Mo del. A communications architecture, a dopted by the ISO in 1984, that includes seven layers that define the functio ns involved in communications between two systems, the services requi red to perform these functi ons, and the protocols associated with the se serv[...]

Glossary OSI/FT AM Respon der Manua l — 425199-00 1 Glo ssary - 18 example, a default se t of permitted actions th at is always used for a specific docume nt type regardless of what is propo sed. The responder implements the se t of permitted actions in some way that maps them onto the underlyi ng real system. Physical Layer . L ayer 1 in the OSI[...]

Glossary OSI/FT AM Respon der Manua l — 425199-00 1 Glo ssary - 19 private group. A free-standing group of FT AM attributes that are outside the scope of OSI standardization. process. A running entity , managed by the Compaq NonStop Kernel, that is crea ted by taking a program from a file on a disk and ru nning it in a processor . process identif[...]

Glossary OSI/FT AM Respon der Manua l — 425199-00 1 Glo ssary - 20 The PSAP is highly system-dependent and generally re fers to the way interlayer communication is accomplished. See also SAP . PSAP address. A presentation address that is used to identify a single PSAP . PSEL (presentation selector). A l ogical address in the Pres entation Lay er [...]

Glossary OSI/FT AM Respon der Manua l — 425199-00 1 Glo ssary - 21 required parameter . (1) In a protocol dat a unit (PDU), a parameter that is always present. (2) In a Compaq programmatic or interactive int erface, a paramet er to a procedure (for example, a procedure in the FT AM API) or to an inter active command (such as an SCF co mmand) th a[...]

Glossary OSI/FT AM Respon der Manua l — 425199-00 1 Glo ssary - 22 SCF (Subsystem Control Facility). A utility that provides a common, interactive management interface for configuring, controlling, and collecting information from Compaq data communications products. SCP (Subsystem Control Point). The process used to provide the focal point for al[...]

Glossary OSI/FT AM Respon der Manua l — 425199-00 1 Glo ssary - 23 service user . An entity that u ses services provided to it by a lower -layer entity . For example, the FT AM initiator is a servi ce user of AC SE and presentation services provided by OSI/AS. Contr ast service provider . session address. See SSAP . Session Layer . L ayer 5 in th[...]

Glossary OSI/FT AM Respon der Manua l — 425199-00 1 Glo ssary - 24 status. A C ompaq pro cedure completion code that indicates the outcome of a call. This code can assume one of nine values. storage group. File attributes that provide information about a file and the data stored in it. Th ese attributes are negotiated at associat ion establishmen[...]

Glossary OSI/FT AM Respon der Manua l — 425199-00 1 Glo ssary - 25 objects. Each subs ystem has a process throu gh which applications can request serv ices by issuing commands defined by that subs ystem; in some cases, this process is t he entire subsystem. Many subsystems also have interactive interfaces. Subsystem Control Facility . See SCF . S[...]

Glossary OSI/FT AM Respon der Manua l — 425199-00 1 Glo ssary - 26 also performs som e managemen t services in the DSM environment. See also NS P process and TSP process. T APS subdevice. A subdevice, maintained by OSI/AS , that enable s communi cation between an FT AM initiator or responder and the T APS process. See subdevice. T eletexS tring. [...]

Glossary OSI/FT AM Respon der Manua l — 425199-00 1 Glo ssary - 27 protocol (IP) of the Network Lay er . TSP processes are provided by the underlying OSI/TS subsystem. See also NSP process and T APS process. UA (unstructured all data units). An access context for which data is transferred as file-contents data el ements; that is, only the data co[...]

Glossary OSI/FT AM Respon der Manua l — 425199-00 1 Glo ssary - 28 warning. An information-only message returned by the system, indicating a possible problem. A warnin g can be sign ificant, but does not cause the comm and or operation to fail. A warning is less serious than an error . Contrast with error . write functional unit. A functional uni[...]

OSI/FT AM Respon der Manua l — 4 25199-00 1 Index - 1 Index A Access context, not available (m essage 5024) A-21 Access contex, for w riting FT AM-2 files 2-6 Access control inco nsitent (mes sage 3016) A-13 Access request viola tes . .. (message 1 1) A-4 Accessing files diagnostic messag es (5000 - 5040) A-18 Access-control attribute 4-17 Access[...]

Ind e x OSI/FT AM Respon der Manua l — 4 25199-00 1 Index - 2 D Compaq FT A M (continued) Guardian file system 1-7 management considerations for remote applications 6-1 interfaces 1-4 responder See Responder , Compaq FT AM services provided 1-2 standards supported viii troubleshooting 5-2 underlying subsys tems 1-4 Compaq Nonstop Kernel 1-2 See a[...]

Ind e x OSI/FT AM Respon der Manua l — 4 25199-00 1 Index - 3 E DSM See Distributed Systems Management (DSM) E EBCDIC character set 2-6 Encoding data 2-5 , 2-6 EOF (end-of-file) att ribute, Guardian 4-15 Error handling 5-1 Errors See Diagnostic messages Escape sequences 2-5 Event Management Service (EMS) DSM component 1-4 event messages 6-3 troub[...]

Ind e x OSI/FT AM Respon der Manua l — 4 25199-00 1 Index - 4 G File-type attribute, Guardian 4- 8 Format effectors 2-5 FPDUs encoding as presentation data 2-6 limits on string-length values 2-5 , 4-10 size limit 4-10 FT AM See Compaq FT AM, ISO FT AM FT AM protocol data units See FPDUs FT AM-1 files data-transfer consider ations 2-4 maximum file[...]

Ind e x OSI/FT AM Respon der Manua l — 4 25199-00 1 Index - 5 K Indication primitives 1-3 Initial attributes al tered (messag e 3018) A-14 Initial attributes n ot possible (message 3002) A-1 1 Initial attributes parameter 4-17 Initiating system, definition of 1-4 Initiator Compaq FT AM and FT AM API 1-3 definition of 1-2 role in architecture 1-2 [...]

Ind e x OSI/FT AM Respon der Manua l — 4 25199-00 1 Index - 6 O Network layer services 1-5 NIST FT AM agreement 2- 1 Nonstop SQL 4-1 1 NSP process 1-5 O Open mappings 4-7 Operating system See Compaq Nonstop Kernel Operation not avail able (messag e 5015) A-21 Operator messages See Event Management Service (EMS) Optional parameters, support for 4-[...]

Ind e x OSI/FT AM Respon der Manua l — 4 25199-00 1 Index - 7 S Relaxation of parameters 2-4 , 4-4 Remote initiator definition of 1-2 interoperability wi th 2-1 Remove-contexts parameter 4-22 Request primitives 1-3 Request procedures, optional parameters supported 4-22 Requested access vi olates ... (me ssage 3028) A-15 Responder , Compaq FT AM a[...]

Ind e x OSI/FT AM Respon der Manua l — 4 25199-00 1 Index - 8 U U Unconstrained service class 4-1 Universal-class parameter 2-4 Unspecific FT AM protocol error (message 1007) A-5 Unspecific initiator error (message 7) A-3 Unspecific responder error (message 1) A-2 Unsupported functional unit (message 2003) A-8 Unsupported parameter values (messag[...]