The following is a list of possible syntax, file, translation, and run time error messages displayed with the PCDRIVER utility.
Syntax Errors
The following errors are detected while parsing the instructions to SYSTEM/NXSERVICES/PCDRIVER. When one of these errors occurs, SYSTEM/NXSERVICES/PCDRIVER will set it's task's VALUE attribute to 9999 and terminate in error (it will P-DS itself) .
"Quote expected." "Close quote missing." "Number expected." "Number too large." "CCS version expected." "Identifier expected." "Close parenthesis expected." "Option expected." "Unexpected item." "Right bracket expected." "Option not valid when using MCP REDIRECTOR." "Option not valid when using launcher.exe." "Command expected." "Command not valid when using MCP REDIRECTOR." "Invalid context for this option." "Boolean value expected." "File kind expected." "Invalid value for UNITS option." "Invalid value for RECORDS option." "Invalid value for OVERFLOW option." "Number too small." "Input too long."
Instructions File Errors
When the string parameter to SYSTEM/NXSERVICES/PCDRIVER contains the name of a file and there is an error accessing that file, SYSTEM/NXSERVICES/PCDRIVER will display one of the following errors, set it's task's VALUE attribute to 9999, and terminate in error (it will P-DS itself).
"Invalid file name" "File not available" "File has inappropriate FILEKIND" "File's BLOCKSTRUCTURE is not FIXED" "Byte stream file not supported"
Translation Errors
When a required translation is not possible, SYSTEM/NXSERVICES/PCDRIVER will display one of the following errors, set it's task's VALUE attribute to 9999, and terminate in error (it will P-DS itself).
"Unsupported CCSVERSION: <number>" The system CCSVERSION (as specified by SYSOPS CCSVERSION) is not known to this version of SYSTEM/NXSERVICES/PCDRIVER. "No translation for CCSVERSION: <number>" The version of CENTRALSUPPORT in use does not contain the required translation tables for this CCSVERSION.
Run-Time Errors
When SYSTEM/NXSERVICES/PCDRIVER terminates, the TASK value attribute is set to a value that is partitioned into two fields as follows:
[37:32] If PCDRIVER executed any RUN or LOCKEDRUN commands, this field will contain the value returned by the PC program on the last of those runs. [5:6] An enumerated value reflecting the result of the PCDRIVER run.
For example, a value of 129 would indicate that PCDRIVER completed successfully (129.[5:6] = 1 = RESULT_SUCCESS) and that the last (or only) PC program it caused to run returned a value of 2 (129.[37:32] = 2).
The enumerated values returned in [5:6] are as follows. RESULT_SUCCESS is used only if all commands are successful. Otherwise, all commands following the command that incurred the error are skipped, the enumerated value reflects the result of the command that failed, and SYSTEM/NXSERVICES/PCDRIVER terminates in error (it will P-DS itself).
RESULT_SUCCESS = 1
Success.
RESULT_UNKNOWNREQUEST = 2
Error message: "Request not known to PC"
launcher.exe does not support the request issued by SYSTEM/NXSERVICES/PCDRIVER.
RESULT_PROGRAMINITIATIONFAILED = 3
Error message: "Run of program on PC failed"
The specified program is missing, or some other problem (such as security restrictions) prevented it from running.
RESULT_WORKINGDIRECTORYNOTFOUND = 4
Error message: "Working directory not found"
The directory specified by the DIR option was not valid, or (if DIR was not specified) the TEMP environment variable on the PC is not viable.
RESULT_REMOVEFILEFAILED = 5
Error message: "Remove file on PC failed"
The specified file could not be removed because of a security restriction or a sharing violation.
RESULT_PCFILEEXISTS = 6
Error message: "Specified PC file already exists"
SYSTEM/NXSERVICES/PCDRIVER and launcher.exe do not overwrite existing files. If you wish to overwrite an existing file, REMOVE the existing file first. (The REMOVE command does not produce an error if no file exists.)
RESULT_PCFILECREATEERROR = 7
Error message: "Attempt to create PC file failed"
Probably caused by a file naming restriction, a security restriction, or an out of resource condition on the PC.
RESULT_NOPCFILE = 8
Error message: "File not found on PC"
The specified file does not exist.
RESULT_PCFILEOPENERROR = 9
Error message: "Attempt to open PC file failed"
Probably caused by a file naming restriction, a security restriction, a sharing violation, or an out of resource condition on the PC.
RESULT_PCFILEREADERROR = 10
Error message: "Read of PC file failed"
Probably caused by a hardware error or an out of resource condition on the PC.
RESULT_PCFILEWRITEERROR = 11
Error message: "Write to PC file failed"
Probably caused by a hardware error or an out of resource condition on the PC.
RESULT_PCFILECLOSEERROR = 12
Error message: "Attempt to close PC file failed"
Probably caused by a hardware error or an out of resource condition on the PC.
RESULT_CONFUSION = 13
Error message: "PC received an incorrect message during data transfer"
The dialog between SYSTEM/NXSERVICES/PCDRIVER and launcher.exe has become incorrect. (Normally, this error should not occur.)
RESULT_PASSWORDERROR = 14
Error message: "Password error"
The password supplied to SYSTEM/NXSERVICES/PCDRIVER did not match the password supplied to launcher.exe.
RESULT_NORESPONSE = 30
Error message: "No response from PC"
SYSTEM/NXSERVICES/PCDRIVER was not able to establish a TCP/IP connection to launcher.exe.
RESULT_TCPTOLAUNCHERFAIL = 31
Error message: "Communication with PC lost"
A read or write from/to the PC failed.
RESULT_BADTITLE = 32
Error message: "Bad title of file on MCP system"
An attribute error occurred attempting to set TITLE.
RESULT_NOMCPFILE = 33
Error message: "File not found on MCP system"
RESULT_BADMCPFILE = 34
Error message: "File on MCP system has inappropriate attributes"
For example, TEXTDATATOPC will not work with a code file.
RESULT_MCPFILEEXISTS = 35
Error message: "Specified file already exists on MCP system"
SYSTEM/NXSERVICES/PCDRIVER does not overwrite existing files.
RESULT_MCPFILEREADERROR = 36
Error message: "Read of file on MCP system failed"
RESULT_MCPFILEWRITEERROR = 37
Error message: "Write to file on MCP system failed"
RESULT_PROGRAMFAILED = 38
Error message: "PC program returned unexpected result. Result returned: "
RUN or LOCKEDRUN specified acceptable RESULT value(s), and the PC program returned a value not in that set.
RESULT_BADPCFILENAME = 39
Error message: "Syntax error in share designation or in PC file name"
While using MCP redirector to access the PC, the UNC file name (constructed from the share name and the file name) was rejected.
RESULT_SHARENOTKNOWN = 40
Error message: "Share name not valid on PC"
While using MCP redirector to access the PC, the PC rejected the supplied share name.
RESULT_BADCREDENTIALS = 41
Error message: "Credentials rejected by PC"
While using MCP redirector to access the PC, the PC rejected the supplied credentials (which were taken from the CREDENTIALS option or were the MCP redirector defaults).
RESULT_PCCONNECTFAIL = 42
Error message: "Attempt to connect to PC failed"
While using MCP redirector to access the PC, the PC could not be found.
RESULT_MCPFILESIZELIMIT = 43
Error message: "File on MCP system too large"
If this is because the file has reached the maximum number of areas, use of the AREABYTES option may help. (If DRC limits are the issue, AREABYTES will not help.)
RESULT_MCPFILETRUNCATION = 44
Error message: "File record overflow"
When OVERFLOW=ERROR, this indicates that a record was too large.
When OVERFLOW=FOLD or OVERFLOW=WRAP, this indicates that a record was larger than 65535 bytes. (This probably indicates that the source file contained binary data rather than ASCII text, or that the ASCII text is not divided into records by CR LF.)
Run-Time Warning
When record overflow occurs and OVERFLOW=TRUNCATION, SYSTEM/NXSERVICES/PCDRIVER will display the "File record overflow" message as a warning, and will set its task's SW1 attribute to TRUE.
