Personal computer source to iSeries target considerations for DDM

 

iSeries™ Access Family uses DDM to allow a personal computer to communicate as a source server to access objects on an iSeries target. iSeries Access Family uses Level 3.0 of the DDM architecture stream file access support to access folder management services (FMS) folders and documents.

The following considerations apply to iSeries Access Family use of the i5/OS^® DDM target support for the DDM architecture, Level 3.0. Other source servers that send Level 2.0 or Level 3.0 DDM architecture requests for stream files and directories may be able to use this information to help in connecting to an iSeries server by using DDM.

• A FMS must follow the file or directory name to access folder management services (FMS) folders and documents. There can be one or more blanks between the end of the name and the FMS.

• A leading slash (/) signifies the name is fully qualified. If there is no leading slash, any current directory in use is added to the front of the name given.

• The total length of a fully qualified document name is 76 characters. This includes any current directory that may be in use. This does not include the trailing FMS, which is used for typing purposes.

• A / FMS signifies the root folder for a directory name.

• To reduce the number of messages logged to the job log, some errors occurring on the iSeries target during open, get, put, and close document operations are not logged to the job log. See Table 1 for an illustration of these return codes.

  Table 1. iSeries return codes

  Description	DDM reply	Function
  Folder not found	DRCNFNRM	OPEN
  Folder in use	DRCIUSRM	OPEN
  Document in use	FILIUSRM	OPEN
  Document not found	FILNFNRM	OPEN
  Document not found	EXSCNDRM	DELFIL
  Document is read only	ACCINTRM	OPEN
  End of data	SUBSTRRM	GET
  Data stream (DS) in use	STRIUSRM	GET
  Data stream (DS) in use	STRIUSRM	PUT
  Substring not valid	SUBSTRRM	UNLOCK
  Unlocking a region that is not locked	EXSCNDRM	UNLOCK
  File already open for the declare name	OPNCNFRM	OPEN
  File not open	FILNOPRM	GET, PUT, LOCK, UNLOCK
  Delete document SHDONL(TRUE) specified, but shadow does not exist	EXSCNDRM	DELFIL

• To provide better performance, the iSeries target handles the closing document in a manner such that when the document is closing, a command completion reply message (CMDCMPRM) is returned to the source server before the document is actually closed. If the document is damaged during the closing time, the user never receives this reply message unless he views the job log. When the user opens the file again, the updated data may not be there.

• An iSeries server does not support wait on the locking data stream function. The user on the source system must handle the wait function.

 

Parent topic:

Operating considerations for DDM