MSIR.0667 Janus Sockets ($function) failed: (reason): Difference between revisions
Jump to navigation
Jump to search
mNo edit summary |
(Automatically generated page update) |
||
| (4 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
This message indicates that a | This message indicates that a [[SOUL]] application issued a call to the [[Janus Sockets]] $function shown by '''''$function''''', and it failed. The documentation for '''''$function''''' shows the return codes that can occur when it fails to complete successfully. Your application should test the return code, and if it indicates failure, should take the appropriate action. | ||
For example, the message "Already have <var>SOCKPMAX</var> sockets open on port" is accompanied by return code -109 from <var>[[$Sock_Conn]]</var>; your application might issue <var>[[$Sock_Close]]</var> for another socket which is in use on the same port, or you might avoid that failure in the future by using a different <var>[[SOCKPMAX (JANUS DEFINE parameter)|SOCKPMAX]]</var> parameter on the <var>[[JANUS DEFINE]]</var> command for that port. | For example, the message "Already have <var>SOCKPMAX</var> sockets open on port" is accompanied by return code -109 from <var>[[$Sock_Conn]]</var>; your application might issue <var>[[$Sock_Close]]</var> for another socket which is in use on the same port, or you might avoid that failure in the future by using a different <var>[[SOCKPMAX (JANUS DEFINE parameter)|SOCKPMAX]]</var> parameter on the <var>[[JANUS DEFINE]]</var> command for that port. | ||
[[Category: | {{Template:MSIR.0667 footer}} | ||
[[Category:MSIR.0600 - MSIR.0799]] | |||
Latest revision as of 23:33, 3 March 2017
This message indicates that a SOUL application issued a call to the Janus Sockets $function shown by $function, and it failed. The documentation for $function shows the return codes that can occur when it fails to complete successfully. Your application should test the return code, and if it indicates failure, should take the appropriate action.
For example, the message "Already have SOCKPMAX sockets open on port" is accompanied by return code -109 from $Sock_Conn; your application might issue $Sock_Close for another socket which is in use on the same port, or you might avoid that failure in the future by using a different SOCKPMAX parameter on the JANUS DEFINE command for that port.
Message attributes:
| RETCODEO=0 | Sets online return code |
|---|---|
| RETCODEB=4 | Sets batch (single user) return code |
| CLASS=E | Error class; the message can be suppressed with the X'04' bit setting of the MSGCTL parameter |
| AUDITAD | Writes the message with line type AD to the audit trail |
| NOCOUNT | Does not increment the error count (ERCNT) parameter |
| NOTERM | Does not display the message on the user's terminal |