background image

Index

OSI/FTAM Responder Manual— 425199-001

Index -6

O

Network layer services

1-5

NIST FTAM agreement

2-1

Nonstop SQL

4-11

NSP process

1-5

O

Open mappings

4-7

Operating system

See Compaq Nonstop Kernel

Operation not available (message 
5015)

A-21

Operator messages

See Event Management Service (EMS)

Optional parameters, support for

4-21

OSI Reference Model, Compaq products 
for

1-4

OSI/AS subsystem

API

3-1

interaction with

1-4

interoperability

2-2

OSI/TS subsystem

1-4

Override deleted and recreated ... (message 
3021)

A-14

Override selected existing file (message 
3020)

A-14

P

Parameters

interoperability

2-3

optional, responder support for

4-21

Password invalid (message 2020)

A-9

Passwords

4-22

PDUs

encoding as presentation data

2-6

functional overview

1-2

size limit

4-10

Performance, increasing

6-2

Permitted-actions violation (message 
3028)

A-15

Presentation layer services

1-5

Presentation-context-management parameter 
(message 2016)

A-9

Primitives

definition of

1-2

See also individual primitives
types

1-3

Procedures, in FTAM API

1-3

Process pairs

6-2

Processing mode inconsistent (message 
5023)

A-21

Processing mode unsupported (message 
5022)

A-21

Process, initiator

See Initiator, Compaq FTAM

Process, responder

See Responder, Compaq FTAM

Programmatic application interface

See FTAM API

Programs

See Applications

Protocol data units (PDUs)

See PDUs

Protocol-error counter

6-2

6-3

Protocol-related diagnostic messages 
(messages 1001-1017)

A-4

PTrace utility

5-2

Q

Quality-of-service parameter not supported 
(message 2014)

A-8

R

READ file access

4-22

Read functional unit

4-2

Reading file attributes

4-20

Read, bad (message 5027)

A-22

Receiver

2-2

Recovery mode not available (message 
6010)

A-25

Recovery strategies

6-2

Summary of Contents for OSI/APLMGR D43

Page 1: ...for programmers and users who are working with or writing remote FTAM applications that use the services of the Compaq responder It is also useful to those with access to the Compaq system who are dia...

Page 2: ...to or accompany the delivery of this computer software the rights of the Government regarding its use reproduction and disclosure are as set forth in Section 52 227 19 of the FARS Computer Software R...

Page 3: ...FTAM Responder Functional Overview 1 1 Compaq FTAM Services 1 2 FTAM Applications 1 2 Management Interfaces 1 4 Architectural Overview 1 4 The Responder and Underlying Subsystems 1 4 The Responder and...

Page 4: ...Compaq File Structures 4 5 Create Mappings 4 5 Select Open Mappings 4 7 Maximum String Length Checking of Data Values 4 10 Limits on Small String Length Values With Large PDUs 4 10 File Attribute Mapp...

Page 5: ...ssages A 10 File Management Related Diagnostic Messages A 16 Access Related Diagnostic Messages A 17 Recovery Related Diagnostic Messages A 25 Glossary Index Figures Figure 1 1 An FTAM Service Using F...

Page 6: ...ction List 4 21 Table 4 15 Compaq Support of Optional Parameters Received in Request PDUs 4 21 Table 4 16 Compaq Support of Optional Parameters Sent in Response PDUs 4 22 Table 4 17 Guardian Access Re...

Page 7: ...responder It is also useful to those with access to the Compaq system who are diagnosing and solving problems involving the Compaq FTAM responder Product Version OSI FTAM D43 OSI APLMGR D43 Supported...

Page 8: ...What s New in This Manual OSI FTAM Responder Manual 425199 001 vi New and Changed Information...

Page 9: ...ntroduction to the Compaq FTAM software from the point of view of programmers writing remote FTAM applications that use the services of the Compaq FTAM responder Section 2 Conformance and Interoperabi...

Page 10: ...71 3 File Transfer Access and Management Part 3 File Service Definition ISO 8571 4 File Transfer Access and Management Part 4 File Protocol Specification ISO 8571 5 File Transfer Access and Management...

Page 11: ...gnostic messages OSI FTAM Configuration and Management Manual This manual provides task oriented information necessary for the installation and management of the Compaq FTAM responder and virtual file...

Page 12: ...Compaq relational database management system and how to plan create and manage NonStop SQL databases This manual is useful to you if your applications access SQL tables as FTAM 2 files NonStop SQL Mes...

Page 13: ...The items in the list may be arranged either vertically with aligned brackets on each side of the list or horizontally enclosed in a pair of brackets and separated by vertical lines For example FC nu...

Page 14: ...iod and any other items process name su name Line Spacing If the syntax of a command is too long to fit on a single line each continuation line is indented three spaces and is separated from the prece...

Page 15: ...ext that is displayed or returned exactly as shown For example Backup Up lowercase italic letters Lowercase italic letters indicate variable items whose values are displayed or returned For example p...

Page 16: ...inary number The H notation precedes a hexadecimal number For example 005400 P p register E e register Notation for Management Programming Interfaces The following list summarizes the notation convent...

Page 17: ...wing Developing FTAM applications or using interactive FTAM applications that run on remote systems and use the services of the Compaq FTAM responder Solving problems involving a Compaq FTAM responder...

Page 18: ...applications on the local or remote computer systems on an OSI network Compaq FTAM can handle the following types of files where the corresponding FTAM document types are listed parenthetically Unstr...

Page 19: ...ces supported in the Compaq FTAM implementation The ISO standard provides flexibility in the level of FTAM function that must be implemented in an ISO conformant system This flexibility implies that a...

Page 20: ...the association The system that creates and controls the association is called the initiating system The system that responds to the initiating system is called the responding system In Compaq FTAM t...

Page 21: ...on Layer TAPS processes are provided by the OSI AS subsystem Transport service provider TSP processes perform the services of the Transport Layer These processes are provided by the OSI TS subsystem N...

Page 22: ...ss TSP process and TAPS process to the FTAM responder process Figure 1 2 Compaq FTAM Responder Architectural Overview 204 CDT CDD Network Layer Data Link Layer Transport Layer Session Layer WAN LAN Ph...

Page 23: ...esponder provides that service via its virtual filestore VFS component which acts as an interface to the file system The set of files accessible via the VFS includes all files on the Expand network to...

Page 24: ...Introduction to the Compaq FTAM Responder OSI FTAM Responder Manual 425199 001 1 8 The Responder and the File System...

Page 25: ...OSI FTAM product has been tested to conform with ISO 8571 NIST Special Publication 500 162 Stable Implementation Agreements for Open Systems Interconnection Protocols Part 9 FTAM Phase 2 and US GOSIP...

Page 26: ...Compaq FTAM both the initiator and the responder have sender and receiver capabilities For example an initiator sending a read request is the receiver and an initiator sending a write request is the...

Page 27: ...the future filesize attribute sent in create and change attribute requests The Compaq responder creates files with a maximum future filesize value of 1 GB If a value greater than 1 GB is requested th...

Page 28: ...ted at all by Compaq FTAM Mapping of Contents Type Parameters The Compaq FTAM virtual filestore VFS supports the Compaq FTAM responder by providing an interface to the Guardian file system It maps FTA...

Page 29: ...string length limitation When sending data to the remote initiator it does not check for escape sequences but simply counts all bytes and packages them into strings Use of Format Effectors Format eff...

Page 30: ...hen FTAM 2 files are written using the FA access context the responder expects each text data element transferred to be preceded by a node descriptor data element If the node descriptor element is omi...

Page 31: ...single ASN1 type When F DATA requests are sent by the Compaq responder the method of encoding depends on the number of data elements to be encoded If only a single data element is to be sent it is pla...

Page 32: ...Conformance and Interoperatility OSI FTAM Responder Manual 425199 001 2 8 Presentation Encoding of FTAM PDUs and Data...

Page 33: ...data or process management messages for example Figure 3 1 shows the following responder components The protocol state machine receives requests for new FTAM associations and for FTAM services in the...

Page 34: ...ction assume that the remote initiator sends an FTAM request and the responder returns a response to that request This sequence of steps assumes that you have already established an association The nu...

Page 35: ...n is valid performs the requested action communicating with the VFS where file system access is required 6 The VFS accesses the file system via standard procedure calls and informs the protocol state...

Page 36: ...Compaq FTAM Responder Operation OSI FTAM Responder Manual 425199 001 3 4 Responder Data Flow...

Page 37: ...n depends on which FTAM functions are supported both by the Compaq FTAM responder and the remote FTAM initiator with which it is interoperating The following four tables identify the FTAM service clas...

Page 38: ...SO defined attribute groups except the private group Attribute Support Table 4 4 identifies the FTAM attributes that the Compaq responder supports and the type of support given full or partial In the...

Page 39: ...AM Responder Attribute Group File Attribute Level of Support Kernel Filename Full Permitted actions Full Contents type Full Storage Storage account Partial Date and time of creation Partial if protect...

Page 40: ...ons specifications that change the parameter values of a document type are not permitted by Compaq FTAM For more information on simplification and relaxation see the subsection Contents Type Attribute...

Page 41: ...ace to the Guardian file system The Compaq implementation of the VFS maps Compaq FTAM file structures and attributes to Guardian file structures and attributes and vice versa Tables 4 6 and 4 7 show m...

Page 42: ...ate request However this information is lost when the association is terminated On subsequent accesses to the file via a select request followed by an open request with a contents type of unknown the...

Page 43: ...ructure Contents Type Compaq File Structure FTAM Document Types Default Parameter Values Description File Type File Code Record Length FTAM 1 universal class 25 Graphic String maximum string length no...

Page 44: ...or that document type and string significance value as follows where record length is the standard Guardian file attribute that stands for the maximum record length If the proposed maximum string leng...

Page 45: ...sequenced This is the standard Guardian file attribute that stands for the maximum record length This value represents the Compaq responder default for NBS 9 files on an open If you open an NBS 9 fil...

Page 46: ...ns on FTAM 3 files with a string significance value of fixed the responder does check for strings whose length is smaller than the maximum string length value If any such strings are found the respond...

Page 47: ...DUs that contain primitive strings PDUs containing constructed strings have additional overhead As mentioned above the encoded data limit is 16 KB NE 1 SIGMA ZLEN i TAG LEN NS 16384 bytes 16 KB i 0 wh...

Page 48: ...tion lists the Compaq file structures including file type and file code created when you use the file open service with any supported contents type except NBS 9 Table 4 7 shows how the responder maps...

Page 49: ...d for FTAM 3 documents with a string significance value of not significant the VFS has no memory of the associated maximum string length value Table 4 9 shows the simplification of document types that...

Page 50: ...ameter on the F OPEN Note Because using DIRLIS uppercase in the F SELECT primitive returns the directory file and Guardian file names are not case sensitive you should use dirlis lowercase in the F SE...

Page 51: ...d availability The Compaq responder supports only immediate availability Filesize corresponds to the Guardian file attribute EOF end of file which returns the number of bytes in the file Filesize is a...

Page 52: ...nts as needed are allocated No diagnostic message is returned in this case Note that the maximum size of files is limited by the physical storage capacity of the Compaq disk device being used If an ap...

Page 53: ...d and optionally concurrency access identity passwords and location fields The access control attribute defines the conditions under Identity of creator Partial if protected by Safeguard security soft...

Page 54: ...xecute Purge This mapping is as follows The Compaq responder uses only the first access control element If more than one access control element is present the responder ignores all elements other than...

Page 55: ...esses only the first access control element sent for insert values and for delete values The Compaq responder also ignores all but the first component of the insert values or delete values information...

Page 56: ...s for document types other than NBS 9 it maps the values for access control from Guardian security based on the user ID for the association as defined by the initiator identity parameter sent in the F...

Page 57: ...optional parameters received from a remote initiator Table 4 14 Mapping From Guardian Security to FTAM Action List Guardian Access Action List Bits Set READ Read WRITE Insert Replace Extend Erase Chan...

Page 58: ...t primitive supplies the password used to authenticate the initiator identity DEFUSER includes both the user ID and the Diagnostic Decoded and ignored Access passwords Decoded and ignored Concurrency...

Page 59: ...utes of a file that the Safeguard software protects the access control attribute indicates that no value is available However the Safeguard software still protects FTAM access to the file Note that fo...

Page 60: ...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 EXCLUSIVE if any one of the actions qualify the file s exclusion mod...

Page 61: ...ty Before writing your application you should read Section 2 of this manual Conformance and Interoperability which describes certain aspects of the Compaq FTAM responder that can affect its ability to...

Page 62: ...mpaq FTAM responder as described under Mapping Between FTAM Contents Types and Compaq File Structures in Section 4 It is recommended that you check Further Details whenever you receive a diagnostic me...

Page 63: ...ation about an FTAM association once it is established can be especially useful in troubleshooting The PTrace print trace utility allows the Compaq problem solver to look at trace data generated with...

Page 64: ...Suggestions for Development of Remote Applications OSI FTAM Responder Manual 425199 001 5 4 Troubleshooting...

Page 65: ...em before your application can communicate with the Compaq responder Because of the flexibility and resultant complexity of the configuration of underlying Compaq OSI layers configuration errors are a...

Page 66: ...nager can increase responder capacity by doing one of the following Increasing the maximum number of associations or attaches per responder process Adding more responder processes Increasing Responder...

Page 67: ...example recovery might not be possible You should design your application making backups where necessary with this in mind FTAM configurable files cannot be opened by the responder Event Messages The...

Page 68: ...der virtual filestore VFS file access failures due to file system errors or security violations The responder also returns an event message whenever it starts or completes a file transfer indicating w...

Page 69: ...tions indicate whether an action is to be taken by the application or interactive FTAM user on the initiating system or by the Compaq problem solver on the Compaq system For problems that lie on the i...

Page 70: ...ng length value and a large PDU size caused the incoming data to exceed the responder s data buffer capacity or an internal software error has occurred in the responder Table A 2 Sources and Observers...

Page 71: ...the responder and follow the standard procedures at the Compaq site for contacting the appropriate support personnel These procedures might involve contacting the local Compaq support analyst For deta...

Page 72: ...il event event number 21 Recovery The application or FTAM user can either retry with the correct select request or create request parameters or use initiator ID and filestore password values that supp...

Page 73: ...age Effect The responder aborts the association Recovery The application or FTAM user should retry the request with all mandatory parameters To determine which parameters are mandatory refer to the FT...

Page 74: ...rror code error subcode and original error information displayed in the trace record This information should help identify the problem being detected by the TAPS process For information on configurati...

Page 75: ...the file with the required requested access and retry If the problem persists the Compaq problem solver can use the SCF TRACE command and the PTrace utility to troubleshoot the problem For more inform...

Page 76: ...y functional units that are consistent with the proposed service class on the initialize request 2013 Cause The checkpoint window parameter of the initialize request was set to a value that the respon...

Page 77: ...e presentation context management parameter Effect This is an information only diagnostic message The association is established Recovery No action is necessary 2018 Cause The responder detected one o...

Page 78: ...e initiate indication the responder detected either a value of unconstrained for the service class or no value at all for the service class The remote initiator requested services requiring the manage...

Page 79: ...5 5 File name not found 3002 2 5 5 Initial attributes not possible 3004 2 5 5 Non existent file 3005 2 5 5 File already exists 3006 2 5 5 File cannot be created 3007 2 5 5 File cannot be deleted 3012...

Page 80: ...e request has been sent with the override parameter set so that file creation fails if the file already exists and the file already exists in the file system The CREATE procedure returns an error indi...

Page 81: ...essible and retry the operation 3013 Cause An unexpected operating system error has occurred or the application or FTAM user tried to access an SQL table that is not organization relative Effect The s...

Page 82: ...responder received a create request naming a file that already exists with the override parameter set so that the existing file is to be deleted and a new file created using the attributes of the dele...

Page 83: ...than an FTAM 2 file was selected for insert access Insert access is allowed only on FTAM 2 files nAn FTAM 2 file was selected for replace or extend access or both Replace and extend access is not all...

Page 84: ...e application or FTAM user specified an access control element containing information other than the action list such as concurrency access and identity in the attributes parameter of a change attribu...

Page 85: ...future filesize and access control 4005 Cause The responder has received a change attribute request with an invalid attribute value or the file name was invalid for the Guardian 90 operating system Ef...

Page 86: ...000 2 5 1 Bad FADU unspecific 5001 2 5 1 Bad FADU size error 5003 2 5 1 Bad FADU poorly specified 5004 2 5 1 Bad FADU bad location 5005 0 5 5 FADU does not exist 5008 2 5 5 FADU not available for writ...

Page 87: ...ect The responder cancels the service the association is left in the file open regime and the file is left in an unknown state Recovery The application or FTAM user should issue a cancel response clos...

Page 88: ...ssing mode of insert and the requested access on the select service did not include insert or the processing mode of insert is not allowed for the document type selected Effect The responder rejects t...

Page 89: ...s the association Recovery The application or FTAM user should discard the association context reinitialize an association and proceed with the intended operation The responder simplifies document typ...

Page 90: ...TAM user can retry the application 5027 Cause A local file system error other than an end of file message has occurred on the read service One possible cause of this error is that one of the records i...

Page 91: ...rite service the responder cancels the service and the file is left in an unknown state If the failure occurs during any other action the responder rejects the request Recovery If a failure occurs dur...

Page 92: ...TAM user specified an unsupported value of the universal class parameter Effect The responder rejects the request Recovery The application or FTAM user should retry specifying a valid document type on...

Page 93: ...etry the read and write service omitting the FADU lock parameter Recovery Related Diagnostic Messages Table A 11 displays the diagnostic error code that may be generated during recovery operations 601...

Page 94: ...Compaq FTAM Responder Diagnostic Messages OSI FTAM Responder Manual 425199 001 A 26 Recovery Related Diagnostic Messages...

Page 95: ...of the OSI Reference Model The ACSE exists within an application entity and enables other ASEs to establish and release associations It is accessible to users of OSI AS through the APS procedures See...

Page 96: ...d MFM procedures used in FTAM programming The Compaq FTAM API also includes the data definitions provided in the ZFTMDDL file and all language specific files derived from ZFTMDDL See also APS procedur...

Page 97: ...ntral processing unit CPU number of the Compaq processor on which the backup process will run See backup process backup opener The backup process that has an open to an FTAM initiator or responder pro...

Page 98: ...ing compiling and installing Compaq OSI AS See OSI AS Compaq OSI FTAM See Compaq FTAM Compaq OSI TS See OSI TS compatibility distributor An EMS distributor process that filters event messages accordin...

Page 99: ...s that further define the document type The contents type must either match the document type of the file being opened or be an allowed simplification of the document type If you are using the Compaq...

Page 100: ...e that cannot be broken into smaller segments by the protocol An FTAM 2 document is a structured text file divided into FADUs which cannot be broken down An FTAM 3 document is an unstructured binary f...

Page 101: ...de values that provide more detail about the nature of the problem See error subcode error identifier An ISO defined code included in a diagnostic message that identifies a diagnostic error error obse...

Page 102: ...mantics of the file In Compaq FTAM the only document type that uses FA is FTAM 2 See access context contrast with UA FADU file access data unit A unit of the file access structure on which the transfe...

Page 103: ...ibutes or open the file You can also deselect the file or delete the file and you can abort the association See also data transfer regime file open regime and FTAM regime filestore password parameter...

Page 104: ...a single data unit or as multiple data units See also document types FTAM 3 file An unstructured binary file that can be accessed only as a single data unit See also document types FTC profile A Compa...

Page 105: ...control grouping control A mode of operation that allows your application to perform a sequence of confirmed services in one FTAM event The request primitives for these services are bracketed with the...

Page 106: ...t does not require recovery and does not affect the current state of the file service An informative message provides information to qualify a successful action See also error type permanent error and...

Page 107: ...ved by some indication and confirm procedures In addition programs using the FTAM API can send diagnostic messages to the remote responder using the FTM_CANCEL_REQ_ FTM_DATA_END_REQ_ and FTM_U_ABORT_R...

Page 108: ...and information about applications 2 A database used by APLMGR to store and retrieve FTAM configuration information module file management procedures See MFM procedures named values DDL variables that...

Page 109: ...ns and in some APS operations the mode in which the called procedure initiates an I O operation but does not wait for it to complete before returning control to the caller The application calls a sepa...

Page 110: ...t not always present 2 In the Compaq FTAM API a procedure call parameter that can be included in a given procedure call or command but is not required for use with the procedure or command Contrast wi...

Page 111: ...e attribute name but provides no value for it Contrast with supported file attribute PDU protocol data unit The encoded message transferred across the OSI network between peer entities for example bet...

Page 112: ...n abstract syntax and a transfer syntax on a Presentation Layer connection In Compaq FTAM you have programmatic control over the choice of presentation context related to document types but not over t...

Page 113: ...parameters for Compaq FTAM responder processes When a profile is specified for a process the configuration parameters in the profile take precedence over any corresponding parameters specified for the...

Page 114: ...open regime and data transfer regime register request 1 For Compaq FTAM a request made by the FTAM API to the APLMGR process on behalf of an application to establish an FTAM association Processing an...

Page 115: ...th called address and calling address response primitive A primitive issued when a service user entity wants to respond to an event for confirmed services only This is one of four types of service pri...

Page 116: ...or Compaq data communications subsystems the sensitive commands are those that can change the state or configuration of objects start or stop tracing or change the values of statistics counters Contra...

Page 117: ...tabase SSAP session service access point A network unique address in the Session Layer through which connections are established and maintained also called session address SSEL session selector A logi...

Page 118: ...ice A logical entity maintained by a Compaq subsystem to provide access to a physical connection that is to a communications line There may be one or many subdevices associated with a given line or pr...

Page 119: ...ilestore VFS file attribute that can be referenced or modified Contrast with partially supported file attribute swap disk See swap volume swap volume An optional disk volume used as an additional memo...

Page 120: ...is repeated but does indicate the failure of the operation being performed See also error type informative message and permanent error transition state See state transition transport address See TSAP...

Page 121: ...FTAM responder implements a VFS that translates requests into Guardian file system operations Files accessible via the Guardian file system can also be accessed via the VFS component of the Compaq FT...

Page 122: ...esponder Releasing the file open regime X25AM X 25 Access Method A Compaq product that implements the services of the Network Layer and the Physical Layer for WANs X 25 network Any network or subnetwo...

Page 123: ...e changed message 4002 A 16 Attribute not supported message 4003 A 17 Attribute partially supported message 4006 A 17 Attributes bad value message 4005 A 17 initial altered message 3018 A 14 initial n...

Page 124: ...mappings 4 5 Create override deleted and created message 3022 A 14 Create password parameter 4 22 Creating files access control 4 17 Creation attribute 4 16 D Data calculating decoded data size 4 10...

Page 125: ...considerations 4 22 File continued types of 4 22 handling overview 1 1 management diagnostic messages 4001 4006 A 16 size 4 15 size limitations 2 3 structures mapping to contents types 4 5 types suppo...

Page 126: ...iles parameters supported by responder 4 4 permitted actions table of 4 8 Functional unit error message 1009 A 6 Functional unit not available message 3029 A 15 Functional unit unsupported message 200...

Page 127: ...ew 1 1 standards supported viii K Kernel attribute group 4 2 Kernel functional unit 4 2 Kernel group file attributes 4 11 L Last attribute modification attribute 4 16 Last attribute modifier attribute...

Page 128: ...size limit 4 10 Performance increasing 6 2 Permitted actions violation message 3028 A 15 Presentation layer services 1 5 Presentation context management parameter message 2016 A 9 Primitives definitio...

Page 129: ...troubleshooting 5 2 virtual filestore VFS 1 1 2 4 responder Compaq FTAM interoperability 2 1 Responding system definition of 1 4 Response primitives 1 2 1 3 Response procedures optional parameters su...

Page 130: ...parameter values message 1001 A 5 Unsupported service class message 2002 A 8 V Viewpoint application 6 3 Virtual filestore VFS 3 1 Expand network 1 7 file attributes and Guardian file attributes 4 11...

Reviews: