Compaq OSI/APLMGR D43 Скачать руководство пользователя страница 65 | Manualshive

Страница: 65 / 130

Compaq OSI/APLMGR D43 Скачать руководство пользователя страница 65

OSI/FTAM Responder Manual— 425199-001

6 -1

6

Responder Manager

This section discusses considerations 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 writing or using FTAM applications on the remote system. It
covers the following topics:

•

Notes on configuration

•

Fault tolerance

•

Event messages

Full details on FTAM configuration, management, and troubleshooting on the Compaq
system are provided in the

OSI/FTAM Configuration and Management Manual

.

Notes on Configuration

Compaq FTAM (responder and

APLMGR

processes), the OSI/AS subsystem, the

OSI/TS subsystem, and TLAM (or PAM for G06 and above releases) or X25AM or
TCP/IP must be configured and running on the Compaq system 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 common cause of problems in Compaq
FTAM applications. The Compaq problem solver should pay special attention to
checking the configuration of Compaq FTAM and the configuration of the underlying
OSI layers (via Compaq OSI/AS).

The following aspects of configuration are important to writers and users of remote
FTAM applications:

•

OSI address

of responder

•

Initiator-identity and filestore-password parameters

•

Protocol error counter

•

Ways to increase responder capacity

•

Ways to increase responder performance

OSI Address of Responder

The assigned OSI address of each responder process is configured on the Compaq
system. Remote applications must refer to this address when requesting the services of
the responder. Several responders can be assigned to the same address.

«
...
63
64
65
66
67
...
»

Содержание OSI/APLMGR D43

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 8: ...What s New in This Manual OSI FTAM Responder Manual 425199 001 vi New and Changed Information...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 24: ...Introduction to the Compaq FTAM Responder OSI FTAM Responder Manual 425199 001 1 8 The Responder and the File System...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 32: ...Conformance and Interoperatility OSI FTAM Responder Manual 425199 001 2 8 Presentation Encoding of FTAM PDUs and Data...

Страница 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...

Страница 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...

Страница 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...

Страница 36: ...Compaq FTAM Responder Operation OSI FTAM Responder Manual 425199 001 3 4 Responder Data Flow...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 64: ...Suggestions for Development of Remote Applications OSI FTAM Responder Manual 425199 001 5 4 Troubleshooting...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 94: ...Compaq FTAM Responder Diagnostic Messages OSI FTAM Responder Manual 425199 001 A 26 Recovery Related Diagnostic Messages...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Отзывы:

Нет отзывов