Interface Messages

The following is a list of Interface messages. They are stored in 'prefix.IMS.DATA(FOCIMS)' for MVS and in FOCIMS ERRORS for CMS, and they are subject to change.

Messages that refer to the XMI server also apply to the BMP extension.

On-line explanations are available for some messages. To see the explanatory information, issue the following from the FOCUS command level

? n

where:

n

Is a message number.

(FOC4201) RETRIEVAL REQUEST DOES NOT REFERENCE ANY DATABASE FIELDS

The user's request does not reference any database fields. For example, it uses only defined fields that require no access to data, such as X = X + 1.

(FOC4202) INSUFFICIENT MEMORY FOR IMS INTERFACE

More memory is needed to construct tables and SSAs. Generally about 4K of additional memory will suffice. If that is not possible, reduce the sort work area by reducing the number of bins through the command SET BINS = m. A minimum of 13 bins is required.

(FOC4203) LOGIC ERROR IN SSA GENERATION

Interface logic error-call your IBI representative.

(FOC4204) NO LOCAL PCB FOR FILENAME

No PCB could be found corresponding to the displayed Master File member name. Verify that the Master File member name has a matching entry in the FOCPSB description.

(FOC4205) CANNOT LINK TO XMI REGION FOR DDNAME

The displayed ddname allocated a communication dataset but there is no active XMI server job for it.

(FOC4206) CANNOT ENQUEUE ON MAILBOX OF XMI REGION FOR DDNAME

Communication error-call your IBI representative.

(FOC4207) CANNOT TRANSMIT PCB MESSAGE TO XMI REGION FOR DDNAME

Communication error-call your IBI representative.

(FOC4208) CANNOT RECEIVE PCB REPLY FROM XMI REGION FOR DDNAME

Communication error-call your IBI representative.

(FOC4209) CANNOT DEQUEUE MAILBOX OF XMI REGION FOR DDNAME

Communication error-call your IBI representative.

(FOC4210) BUSY PCB RETURNED BY XMI REGION FOR DDNAME

Communication error-call your IBI representative.

(FOC4211) NO XMI REGION HAS ANY PCB FOR FILENAME

The XMI server is used, but none of the active XMI server jobs has a PCB corresponding to the displayed filename. The FOCPSB allocation may have been omitted from the server JCL.

(FOC4212) NO FREE PCB IN ANY XMI REGION FOR FILENAME

The XMI server is used and all PCBs corresponding to the displayed filename are in use. Try again later.

(FOC4213) LOCAL DLI CALL ERROR STATUS FOR SEGMENT

The XMI server is not used and the locally issued DL/I call returned the displayed IMS error code. Refer to Common User Errors, for typical STATUS codes that accompany this message.

(FOC4214) REMOTE DLI CALL ERROR STATUS FOR SEGMENT

The XMI server is used and the XMI server job servicing this retrieval obtained the displayed IMS error message code. Refer to Common User Errors, for typical STATUS code values that accompany this message.

(FOC4215) LOCAL PSB HAS MORE THAN ONE PCB FOR FILENAME

(FOC4216) XMI PSB HAS MORE THAN ONE PCB FOR FILENAME

(FOC4217) ERROR CREATING BMP MESSAGE FOR SEGMENT

Communication error-call your IBI representative.

(FOC4218) BMP MESSAGE TOO LONG FOR SEGMENT

Communication error-call your IBI representative.

(FOC4219) CANNOT ENQ MAILBOX .. MAILBOX STILL IN USE

Communication error-call your IBI representative.

(FOC4220) CANNOT SEND MESSAGE .. MAILBOX STILL IN USE

Communication error-call your IBI representative.

(FOC4221) CANNOT RECEIVE MESSAGE .. MAILBOX STILL IN USE

Communication error-call your IBI representative.

(FOC4222) I/O ERROR ON FILE FOCPSB

File FOCPSB was allocated and an I/O error occurred trying to read it.

(FOC4223) INVALID PCB ATTRIBUTE FOR FILENAME

File FOCPSB is allocated and contains a record with an invalid PCBTYPE attribute.

(FOC4224) FILE FOCPSB IS ALLOCATED BUT IT IS EMPTY

File FOCPSB was allocated but was empty or contained only comment records.

(FOC4225) JOIN MUST BE DONE TO THE ROOT SEGMENT

The 'TO' field in the JOIN must be in the root segment as seen through the PCB. Check the PSBGEN and clear the JOIN with the following command:

JOIN CLEAR joinname

(FOC4226) 'TO' FIELD IN JOIN DOESN'T HAVE IMS KEY

The 'TO' field must have an ALIAS value that includes the suffix .KEY or .HKY in the Master File of the database cross-referenced in the JOIN (e.g., ALIAS=SSN.KEY).

(FOC4227) ACTUAL AND USAGE FORMATS OF 'FROM' & 'TO' FIELDS DIFFER

The actual format of the 'FROM' and the usage format of the 'TO' field must be the same. No format conversion is allowed or will be performed.

(FOC4228) ACTUAL AND USAGE FORMATS OF 'TO' FIELD ARE DIFFERENT

The actual and usage formats of the 'TO' field must be the same. No data conversion is allowed or needed.

(FOC4229) FORMATS OF 'TO' AND 'FROM' FIELDS ARE DIFFERENT

The formats of 'TO' and 'FROM' fields must be the same or their values must be comparable.

(FOC4230) GROUP FLDS IN JOIN MUST HAVE AN EQUAL NUMBER OF ELEMENTS

(FOC4231)

(FOC4232) CALLIMS ERROR ON ISRT CALL

(FOC4233) CALLIMS ERROR ON PURG CALL

(FOC4234) 'TO' SEGMENT IN JOIN IS NOT S1,S2,SH1,SH2

The 'TO' field is in a segment defined with a SEGTYPE of S0 or blank, indicating that there is no key for the segment. The JOIN command supports only keyed IMS segments-SEGTYPEs S1, S2, SH1, and SH2.

(FOC4235) WARNING: DATA RETRIEVAL TERMINATED DUE TO DLI LIMIT

Data retrieval was terminated because of a limit imposed by the DBA. A report is displayed but may be incomplete due to this resource restriction.

(FOC4236) GATEWAY MACHINE IS NOT RUNNING

Unable to communicate with the gateway machine. The gateway machine must be operating prior to a request for data from a DL/I database. Gateway user ID is not logged on or the gateway program is not running.

(FOC4237) GATEWAY - TARGET LINK IS NOT OPERATIONAL

The gateway machine was unable to communicate with the database server in the other operating environment. Most likely the database server was not started prior to the report request.

(FOC4238) VMCF ERROR COMMUNICATING TO THE GATEWAY MACHINE

Communication error. Most likely the gateway machine was logged off in the middle of a request. Restart the gateway and rerun the report request.

(FOC4239) CALLIMS ERROR ON CHKP CALL

(FOC4240) CALLIMS ERROR ON GN CALL

(FOC4241) BADPARMS TO CALLIMS

(FOC4242) USE COMMAND IS MISSING FOR FILE

The USE command for access to a DL/I database does not include the filename displayed in the error message.

(FOC4243) GATEWAY ID NAME IS MISSING IN THE USE COMMAND FOR FILE

The gateway user ID is missing from the USE command. The USE command syntax to access DL/I data is either of the following:

USE FILENAME DLI * ON GATEUSERID

USE * DLI * ON GATEUSERID

(FOC4244) JOIN CAN BE DONE ONLY TO A FULL HDAM KEY

If the 'TO' database is HDAM, you cannot do a short-to-long (partial to full) key JOIN.

(FOC4245) Reserved

This message is reserved for CALLIMS client-server communication.

(FOC4246) Reserved

This message is reserved for CALLIMS client-server communication.

(FOC4247) INVALID IMS COMMAND

(FOC4248) INVALID PARAMETER IN IMS SET COMMAND

(FOC4249) PSB NAME IS MISSING

(FOC4250) DBCTL IS NOT INITIALIZED FOR THIS ADDRESS SPACE

(FOC4251) DBCTL INITIALIZATION FAILED WITH

(FOC4252) IMD IS OUT OF MEMORY

(FOC4253) BAD PARAMETER LIST ON IMD CALL, RC

(FOC4254) ERROR LOADING DRA STARTUP MODULE

(FOC4255) DBCTL TERMINATION FAILED WITH

(FOC4256) DBCTL SESSION HAS NOT BEEN TERMINATED

(FOC4257) OPEN THREAD FAILED WITH

(FOC4258) TERMINATE THREAD FAILED WITH

(FOC4259) THE DATA IS INCOMPLETE: DBCTL SESSION HAS BEEN RECYCLED

(FOC4260) SET IS INVALID, FOCPSB IS NOT PARTITIONED

(FOC4261) FOCPSB MEMBER NOT FOUND

(FOC4262) FOCPSB IS NOT ALLOCATED

(FOC4263) FOCPSB IS ALLOCATED TO AN INVALID MEMBER OF A PDS

(FOC4264) INVALID SET OPTION. IMSMODE CANNOT BE SET VIA THIS COMMAND

(FOC4265) SECURITY CHECK FAILED. RESOURCE CLASS MISSING

(FOC4266) SECURITY CHECK FAILED. INSUFFICIENT AUTHORITY

(FOC4267) SET RESOURCE CLASS FAILED. INSUFFICIENT AUTHORITY

Security profile is owned by the server, individual users cannot change it.

(FOC4268) SET SECURITY FAILED. INSUFFICIENT AUTHORITY

(FOC4269) REQUEST TO CHANGE DFSPZP SUFFIX WAS DENIED

Individual users are not allowed to change PZP suffix in EDA/MSO environment.

(FOC4270) THIS REQUEST IS RUNNING AGAINST INCOMPATIBLE SERVER

Client is running OLD IMS and the XMI server is NEW, or client is running the NEW IMS interface (IMSX) and the XMI server is OLD.

(FOC4271) FOCPSB HAS MORE PCB ENTRIES THAN THE ACTUAL PSB

The number of PCB entries in the FOCPSB file is greater than the number of PCBs in the PSBGEN of the active PSB.

(FOC4272) CALLIMS ERROR ON CHNG CALL

(FOC4273) CALLIMS ERROR OCCURRED

(FOC4274) CALLIMS CRITICAL ERROR

(FOC4275) INVALID IMS MODE ON SERVER

The only valid modes on a server are REMOTE or DBCTL.

(FOC4276) DBCTL HAS BEEN INITIALIZED

(FOC4277) KEY FIELD MISSING FROM SEGMENT:

The segment is defined as keyed, but there is no .KEY field described in the MFD for that segment. Database will be processed sequentially.

(FOC4278)

(FOC4279)

(FOC4280) IMSMODE

(FOC4281) PSB

(FOC4282) IMSSEC

(FOC4283) IMSCLASS

(FOC4284) IMSPZP

(FOC4285) DELAYED SHUTDOWN IS IN PROGRESS FOR DBCTL INTERFACE

(FOC4286) DBCTL SHUTDOWN IS DELAYED, NUMBER OF ACTIVE REQUESTS

(FOC4287) Reserved for IMD

(FOC4288) DBCTL INTERFACE IS

This message will be accompanied by additional DBCTL messages that describe the situation.

(FOC4289) DFSPZP SUFFIX

(FOC4290) IMS SECURITY IS

(FOC4291) IMS RESOURCE CLASS

(FOC4292) NUMBER OF OPEN DBCTL THREADS

(FOC4293) NUMBER OF ACTIVE DBCTL REQUESTS

(FOC4294) Reserved for IMD

(FOC4295) ACCESS POINTS TO DIFFERENT PSBS IN JOIN

All files in a request should point to the same PSBname.

(FOC4296)

(FOC4297)

(FOC4298)

(FOC4299)