User's Guide YCPlex - YCOS - Yves Colliard Software GmbH
Contents
1. YCXCFRMG and YCXCFTST SG DIAG substr arg 1 1 32 extract Diagnosis SG LEN substr arg 1 34 4 length SG INFO substr arg 1 38 4 info SEND SG STCK substr arg 1 42 8 Store Clock SG SYSN substr arg 1 50 8 sending System SG USER substr arg 1 58 8 sending User Id SG_NTOK substr arg 1 66 16 sending Name Tok SG PTRR substr arg 1 ux 4 sending Data Prt SG PARM substr arg 1 86 Length and Data SG PLGT ERE Du CEN length of Data as MSG PREQ substr arg 1 88 8 Requested Function Wi MSG PDAT substr arg 1 96 Parameter Data The user system REXX can now perform the desired function and returns the an swer in the stack QUEUE and a return code may also be delivered QUEUE response EXIT rc YCXCFREX uses YCXCFMGO to send the result reponse back tot he requestor RESP LLT October 2010 V2RO Copyright YCOS Yves Colliard Software GmbH Page 9 45 YCPlex YCOS Sysplex User s Guide 1 2 YCPlex processing The YCPlex processing consists of 4 phases and these are described in the next few pag es 1 2 1 Send Requests SEND YCXCFSTG Assembler D System Rexx Load Message Exit Parms Send Getmain Buffer 100 Msg Req SEND Create Join YOXCFGRP Target System Create STC NTC NTC Name not used Attach YCXCFCMD Pt2. o RESP PRM L DS CL4 Length REQUEST DS CL4 Request RESP SYS SEL DS CL8 System Name selection sysname this system PRM NTC DS CL16 NTC Name TTOKEN 7 Filled during SEND PRM PTRR DS CL4 Pointer to Response Area 7 Filled during SEND PRM PARM DS OCL1 Response 2 Bytes HH Length of Response up to 894 Bytes Response o QURY PRM L DS CL4 Length REQUEST DS CL4 Request QURY SYS SEL DS CL8 not used a PRM NTC DS CL16 not used PRM PTRR DS CL4 not used PRM PARM DS OCL1 Response e 4 Bytes LLLL Number of responses per Response e 8 Bytes SYSTEM System name of response 2 Bytes HH Length of response if 0000 Then no response up to 894 Bytes Response October 2010 V2RO Page 8 45 Copyright YCOS Yves Colliard Software GmbH Ze YCPlex YCOS Sysplex User s Guide e YCXCFREX this System Rexx TSO environment and without time limit must be in stalled in SYS1 SAXREXEC or the concatenation gets control from YCXCFWRK when a SEND request arrives YCXCFREX receives the information 956 buffer in two variables AXREXX restriction YCXCFIN1 and YCXCFIN2 these are reassem bled in the variable YCXCFINF The MSG_PREQ variable will contain the name of a user system REXX that will then be given control with parameters Parameter 1 MSG_DIAG Parameter 2 YOXCFINF This information can be processed as follows in the user REXX see samples
3. Ck ck c ck KKK KK KKK KKK KKK KKK KK KKK KKK ko Bottom of Data KKK KK KKK KK KKK KKK KKK KKK KK KK KKK ko ko October 2010 V2RO Page 20 45 Copyright YCOS Yves Colliard Software GmbH LLT YCPlex YCOS Sysplex User s Guide 1 3 3 Assembler sample YCXCFASM The sample assembler program YCXCFASM invokes YCXCFMGO with the YCXCFRMG parameter All answers are issued per message The sample YCXCFASM must be installed in an APF authorized library compile and bind YCXCFASM needs the MGOPARM macro The program call can be done using a batch job the sample YCXCFASJ can be used LAT October 2010 V2R0 MB Copyright YCOS Yves Colliard Software GmbH Page 21 45 YCPlex YCOS Sysplex User s Guide 2 Installation See YCSLOG YCOS System Logger Utility User s Guide Manual 2 1 STC Started Task The started task must be copied into the PROCLIB concatenation YCPlex name can be used for example Using a STEPLIB is optional and must only be done if the used file was not in cluded the LINKLST concatenation PROG members PLEX YCOS PLEX COMMUNICATION PYRIGHT YCOS YVES COLLIARD SOFTWARI EXEC PGM YCXCFSTC PARM HI HLQ OF E EXX DIAG DATASET DIAGR IB DD DISP SHR DSN HLQ YCSLOG 1 SYSUDUMP DD SYSOUT Figure 8 YCPlex started task Change the PARM if an other HLQ for diagnosis datasets are needed see YCXCFREX System Rexx Diagnosis page 25 2
4. create Message on DIAGRMSG October 2010 V2RO Page 38 45 Copyright YCOS Yves Colliard Software GmbH eS YCPlex YCOS Sysplex User s Guide PTF Date Mod Comment new call YCXCFMGO new YCXCFMGO Parameter P001 14 05 09 Version 1 1 PTF0001 YCXCFASM change of Parameters Sample P001 14 05 09 Version 1 1 PTF0001 YCXCFSND change name of REXX YCXCFMGO Sample new call YCXCFMGO new YCXCFMGO Parameter P001 14 05 09 Version 1 1 PTF0001 YCXCFTST first delivery Sample P001 14 05 09 Version 1 1 PTF0001 YCXCFRMG first delivery Sample P001 14 05 09 Version 1 1 PTF0001 MGOPARM change of Parameters Sample P001 14 05 09 Version 1 1 PTF0001 YCXCFCMD new Modify Command DIAGRMSG Loadlib new Messages YXCFC111 YXCFC15l Load YCXCFMGO during LOADMODS P001 14 05 09 Version 1 1 PTF0001 YCXCFMGI Ignore POST Error Code 4 Msg YXCFIO1A Loadlib Change Response Error messages put Sysname Change NTC Error message DESC Code Compare Store Clock on Response Msg YXCFIO6A P001 14 05 09 Version 1 1 PTF0001 YCXCFMGO Check if TSO get Parms from variable Loadlib set Response to variable SYSAUTH YCXCFINP and YCXCFOUT putline the errors not WTO Check RACF Facility Class YCPLEX SEND RESP Profs Change in Parameters Check of Store Clock Put System name in message YXCFOO6A P001 14 0
5. Command DIAGRMSG modify F OFF executed the option is now inactive 3 5 2 Messages of YCXCFTIM YXCFTO1A ECB MUST BE ZERO Internal error YCPlex will stop all activities User Abend 1113 Review the messages and dump call YCOS support October 2010 V2RO Page 28 45 Copyright YCOS Yves Colliard Software GmbH Ze YCPlex YCOS Sysplex User s Guide 3 5 3 Messages of YCXCFSTC YXCFSO11 YCPLEX COPYRIGHT YCOS GMBH 3333 33 VxRy YCPlex is starting YXCFSO2I YCPLEX STARTING WITH GROUP xxxxxxxx XCF group name YXCFSO3I XCF GROUP xxxxxxxx yyyyyyy BY zzzzzzzz ON tttttttt YCPlex has created joined member zzzzzzzz of XCF group xxxxxxxx on system tttttttt Member zzzzzzzz is the first member in the group yyyyyyy CREATED or has joined the group yyyyyyy JOINED YXCFSO4I YCPLEX INITIALIZATION COMPLETE YCPlex is up and running YXCFSO5I YCPLEX STOPPED YCPlex was stopped YXCFSO6A YCPLEX STOPPED WITH ERRORS Internal error YCPlex has stopped without a stop command all activities Subtask Error User Abend 1111 Review the messages and dump call YCOS support YXCFSO7A PARAMETER LENGTH ERROR Start PARM parameter error YXCFS08A GROUP MEMBER ALREADY ACTIVE ON THIS SYSTEM Error XCF group member is already active on this system YXCFS09A ERROR DURING XCF xxxxx RETURN CODE yyy REASON CODE zzzz General error calling an MVS interface LOADI error loading YCXCFMGI JOIN1 error during IXCJOIN ATTIM err
6. YXCFAO2I Message 35 YXCFAOSI Message 35 YXCFA04A Message 35 YXCFCO1A Message 27 YXCFCO2E Message 27 YXCFCO3I Message 27 YXCFCO4I Message 27 YXCFCO5I Message 27 YXCFCO6I Message 27 YXCFCO7I Message 27 YXCFCO8I Message 27 YXCFCO9I Message 27 YXCFC10I Message 27 YXCFC1 11 Message 27 YXCFC121 Message 27 YXCFC131 Message 28 YXCFC141 Message 28 YXCFDO1 Message 34 YXCFDO2A Message 34 YXCFIO2A Message 32 YXCFIO3A Message 32 YXCFIO4A Message 32 YXCFIO5A Message 32 YXCFIO6A Message 32 YXCFIO7A Message 32 YXCFOO1A Message 31 YXCFO02A Message 31 YXCFOOS3A Message 31 YXCFO04A Message 31 YXCFO05A Message 31 YXCFOO06A Message 31 YXCFOO7E Message 31 YXCFOO8E Message 31 YXCFOO9A Message 31 YXCFO10A Message 31 Datum erstellt October 2010 V2RO Seite 44 45 Copyright YCOS Yves Colliard Software GmbH YCPlex YCOS Sysplex User s Guide YXCFRO11 DIAGRMSG 25 Message 33 YXCFRO2A Message 33 YXCFRO3A Message 33 YXCFRO4A Message 33 YXCFRO05A Message 33 YXCFROGA Message 33 YXCFRO7A Message 33 YXCFS011 Message 29 YXCFSO02I Message 29 YXCFSOSI Message 29 YXCFSO0AI Message 29 YXCFSO5I Message 29 YXCFSOGA Message 29 YXCFSO7A Message 29 YXCFSOBA Message 29 YXCFSO9A Message 29 YXCFTO1A Message 28 YXCFWO1A Message 30 YXCFWO2A Message 30 YXCFWO3A Message 30 LLT October 2010 V2RO Copyright YCOS Yves Colliard Software GmbH Page 45 45
7. 5 45 YCPlex YCOS Sysplex User s Guide YCPlex needs a startet task and uses the system rexx interface it will also create join an own XCF Group YCXCFGRP the member name will be the system name One started task per system will be needed The YCPlex message interface YCXCFMGO must be authorized any address space type can use the interface Following components programms are part of YCPlex e YCXCFSTC the started task of YCPlex is responsible for the following tasks o YCPlex can only be started once per system this will be checked YCPlex uses NTC Name Token Callable Services with a token name CXCFSTC System Name to check it o It loads the message exit YCXCFMGI in the storage This task exit be comes control as an message is coming in received by XCF o Upto 100 messages can be queued in the storage o The XCF group YCSCFGRP with member name system name will be cre ated joined o A NTC YCXCFSTC System Name YCXCFSTC System Name will be create to keep some internal information member token for YCXCFMGO getmain area pointer Debug and ECB pointer Debug o the command subtask will be attached YCXCFCMD o an abend 522 elimination subtask will attached YCXCFTIM no need for TIME 1440 since no long wait time will occurred o the work message subtask will be attached YCXCFWRK This task will be posted by YCXCFMGI to process the received message o the started task wait on the ECBs
8. DO NOT CHANGE IT iii the NTC of the SEND request as provided from the SEND request DO NOT CHANGE IT iv the pointer to the to the response area in the requestor address space v der Pointer zur Response im Ziel Address Space as provided from the SEND request DO NOT CHANGE IT vi the response request area it must contain a length information 2 Bytes including length field The request can including length field be up to 896 bytes long 6 the sender programm YCXCFMGO receives control and executes following actions a the NTC Name Token Callable Services of the started task will be used b the XCF group will be queried c the response will sent over XCF 7 XCF send the response over CTC Channel To Channel or CF Coupling Facility to the requesting YCPlex papo LLT October 2010 V2RO Copyright YCOS Yves Colliard Software GmbH Page 13 45 YCPlex YCOS Sysplex User s Guide 1 2 3 Receiving the response RESP YCXCFSTC Assembler Load Message Exit System Rexx Getmain Buffer 100 Msg Parms Send Create Join YCXCFGRP Eh Create STC NTC NTC Name not usea EEN Er MURUS Ptr to Response not used Store Clock not used Response Data CALL YCXCFMGO Figure 4 receiving the response 1 XCF will transport the request from the sender YCPlex member to the target YCPlex member XCF will post the YCPlex message exit YCXCFMGI 2 The YCXCFMGI message exit a
9. PARM 4 8 SYSAUTH YCXCFINP t lgt PARM length PARM E Call the Assembler Program yrc outtrap ycxcf address tso CALL YCXCFMGO yrc outtrap OFF p Xy do i l to ycxcf 0 yrc AXRWTO ycxcf i end Le EY if rc 0 then do only needed for debugging issue control message XJ p num substr SYSAUTH YCXCFOUT wo 4 number of Responses p num x2d c2x p num lin YXCFDO1I Responses received p num ml id FIRSTLINE yrc AXRMLWTO lin ml id L if p num 0 then do yrc AXRMLWTO ml id E end else do WO wot4 do i 1 to p num p sys substr SYSAUTH YCXCFOUT wo 8 p_lgt substr SYSAUTH YCXCFOUT wots 2 p_lgt x2d c2x p lgt lin System substr SYSAUTH YCXCFOUT wo 8 yrc AXRMLWTO lin ml id D if i p num then lc DE else lc D if p lgt 0 then do lin Error Time out no response within 10 seconds p_lgt 2 end else do p prm substr SYSAUTH YCXCFOUT wot10 p lgt 2 if left p prm 5 YXCFR then Message from YCXCFREX if p lgt 42 then do inf left p prm 40 inf inf right p prm min 3 p lgt 42 end else do inf left p prm p lgt 2 end lin right p 1gt 3 Bytes RESP inf end yrc AXRMLWTO lin ml id lc wo wo 10 p lgt 2 end end end October 2010 V2RO Page 18 45 Copyright YCOS Yves Colliard Software GmbH Ze YCPlex YCOS Sysplex User s Guide else do yrc AXRWTO YXCFDO2A YCXCFMGO
10. Return Code rc end y E exit Figure 5 sample system rexx request YCXCFSND Sample YCXCFRMG REXX YCXCFMGO Copyright YCOS Yves Colliard Software 2009 10 i System REXX Sample System Rexx Request Handler Wi pe get control from YCPLEX YCXCFREX WW Set O O A A II A a a a dE Sdt V2 0 20 07 2010 new version P005 12 10 2009 Support for Userid propagation V1 2 29 09 2009 delivery El P003 15 07 2009 change receiving parameter P002 20 05 2009 change return response E P001 14 05 2009 first delivery Seene ee ee ee te ee 2 Create a respons Settee Ste 225 SS e E parse pull ycxcfinf MSG DIAG substr arg 1 1 32 extract Diagnosis MSG LEN substr ycxcfinf 1 4 length MSG_INFO substr ycxcfinf 5 4 info SEND MSG STCK substr ycxcfinf 9 8 Store Clock MSG SYSN substr ycxcfinf 17 8 sending System MSG USER substr ycxcfinf 25 8 sending User Id MSG NTOK substr ycxcfinf 33 16 sending Name Tok MSG PTRR substr ycxcfinf 49 4 sending Data Prt MSG PARM
11. YCPlex YCOS Sysplex User s Guide Table of figures Mess io ii A A tect AA lA ete 5 Send eU cn 10 FECEIVING the TOQqUESt p EE 12 receiving hn Ee 14 sample system rexx request VCSCEOND eene nnne enne nn tenen nennen 19 sample system rexx response YOXCFMRG sss nennen entente nsns 19 sample system rexx response YCXCFTST cnn ncn nan nn naar nan tenter sinn nnnnnren 20 ME usc acte ET 22 October 2010 V2RO 1 Copyright YCOS Yves Colliard Software GmbH Page ii YCPlex YCOS Sysplex User s Guide 1 YCPlex YCOS Sysplex 1 1 YCPlex Overview YCPlex YCOS sysplex communication provides a flexible interface within a sysplex the standard XCF cross system coupling facility called basic sysplex services are used The YCPlex interface can be used to send tasks commands actions SEND to other sys tems the answer s can be RESP returned to the caller and queries QURY are al so provided Tasks command actions can be sent to ALL systems ALL to ALL others systems OTHER or to a selected system system name The response have to be sent to a dedicated selected system User Program CALL YCXCFMGO System A System B Work Request your own System Rexx Return result Figure 1 YCPlex overview Yoly October 2010 V2RO MM Copyright YCOS Yves Colliard Software GmbH Page
12. zios are trademarks of International Business Machines Corporation October 2010 V2RO Page 40 45 Copyright YCOS Yves Colliard Software GmbH Xs YCPlex YCOS Sysplex User s Guide 6 Index B Beispiel YCXCFRMG 9 C CF Coupling Facility Channel To Channel see CTC Compile YCPlex 24 Coupling Facility see CF Cross System Coupling Facility see XCF CTC Channel To Channel D Diagnosis System Rexx 25 YCXCFREX 25 DIAGRMSG YCXCFREX 33 YXCFRO011 25 E ECB Event Control Block Event Control Block ECB F F YCPlex LOADMODS 24 F DIAGREXX YCPlex 25 F DIAGRMSG YCPlex 25 FACILITY RACF 7 Installation description 22 Message YXCFAO1I 35 YXCFAO2l 35 YXCFAO3I 35 YXCFA04A 35 YXCFCO1A 27 YXCFCO2E 27 YXCFCOS3I 27 YXCFCO04I 27 YXCFCO5I 27 YXCFCO6I 27 YXCFCO7I 27 YXCFCO8I 27 YXCFCOS9I 27 YXCFC101 27 YXCFC111 27 YXCFC121 27 YXCFC13l 28 YXCFC14I 28 YXCFDO011 34 YXCFDO2A 34 YXCFIO2A 32 YXCFIO3A 32 YXCFIO4A 32 YXCFIO5A 32 YXCFIOGA 32 YXCFIO7A 32 YXCFOO1A 31 YXCFOO02A 31 YXCFOO03A 31 YXCFOO4A 31 YXCFOO05A 31 YXCFOO06A 31 YXCFOO7E 31 YXCFOO8E 31 YXCFOO09A 31 YXCFO10A 31 YXCFRO1I 33 YXCFRO2A 33 YXCFRO3A 33 YXCFRO4A 33 YXCFRO5A 33 YXCFROGA 33 YXCFRO7A 33 YXCFSO1I 29 YXCFSO02I 29 YXCFSOSI 29 YXCFS04I 29 YXCFSO05I 29 YXCFSO6A 29 YXCFSO7A 29 YXCFSO8A 29 YXCFSO9A 29 YXCFTO1A 28 YXCFWO1A 30 YXCFWO2A 30 2g Copyright YCOS Yves Colliard Software GmbH October 2010 V2R0 Page
13. 2 RACF Using the YCXCFMGO interface is subject to protection to RACF Following profiles are used SEND requests e Class FACILITY e Profile YCPLEX SEND function sysname RESP Requests e Class FACILITY e Profile YCPLEX RESP The SEND request can be allowed per function system with a READ permission The RESP request must authorize the SEND users with a READ permission The QURY request is not protected October 2010 V2RO Page 22 45 Copyright YCOS Yves Colliard Software GmbH Ze YCPlex YCOS Sysplex User s Guide 2 3 Performance The started task should be at least be classified to a medium service class of WLM Attention the AXR and the AXR address spaces needs also a medium classification LAT October 2010 V2RO MB Copyright YCOS Yves Colliard Software GmbH Page 23 45 YCPlex YCOS Sysplex User s Guide 3 Operation 3 1 Start of YCPlex Start YCPlex using following MVS start command S YCPLEX 3 2 Stop of YCPlex YCPlex can be stopped using following MVS stop oder modify commands EX EX SHUTDOWN EX STOP EX P 3 3 Modules Versionen PTF and Compile of YCPlex A command is also available to display the modules YCPlex Also versions of PTF status and compile information displayed This information can be very important during debug ging here an example F YCPLEX LOADMODS YXCFCO4I YCXCFESTC COPYRIGHT 2009 10 V2R0 PTFO010 07 05 10 21 YXCFCO5I YC
14. 41 45 YCPLEX YCOS Sysplex User s Guide YXCFWO3A 30 YCPlex 7 Messages Receive Request YCPlex 26 SEND 12 YCXCFASM 35 Receive RESP YCXCFCMD 27 YCXCFMGI 14 YCXCFMGI 32 Receive Response YCXCFMGO 31 RESP 14 VORHER d Receive SEND YCXCFSND 34 YCXCFMGI 12 YCXCFSTC 29 YCXCFREX 12 YCXCFTIM 28 YCXCFSTC 12 YCXCFWRK 30 Modify DIAGREXX n da YCPlex 37 YCPlex 25 Modify DIAGRMSG Request erigi RESP 13 YCPlex 25 SEND 11 Modify LOADMODS RESP YCPlex 24 Module Receive Response 14 YCXCFCMD Request Length 13 S YCXCFMGO 13 YCXCFMGI 6 REXX YCXCFMGO 7 YCXCFSTC 6 YOXCFREX 9 YCXCFTIM 6 e YCXCFWRK 6 Modules sample YCPlex 24 YCPLEXQY 20 YCXCFASM 21 N YCXCFMRG 19 Name Token Callable Services see NTC RE de 2d NTC Name Token Callable Services samples YCPlex 16 o f SEND operation Receive Request 12 overview 24 Request Length 11 Overview Send Request 10 YCPlex 5 YCXCFCMD 11 YCXCFGRP XCF Group 10 P YCXCFMGI 10 Performance YCXCFMGO 11 YCPlexe 23 YCXCFSTC 10 YCPlex 10 YCXCFWRK 11 PTF Send Request YCPlex 24 SEND 10 Shutdown R YCPlex 24 RACF Resouce Access Control Facility Start FACILITY 7 YCPlex 24 Setup 22 STC Started Task Datum erstellt October 2010 V2RO LA Seite 42 45 Copyright YCOS Yves Colliard Software GmbH YCPlex YCOS Sysplex User s Guide Performance 23 Setup 22 Stop YCPlex 24 Support YCPlex 36 System Rexx Diagnosis 25 T__ Task Control Block TCB TCB Task Control Block V Version YCPlex 37 Versi
15. 5 09 Version 1 1 PTF0001 YCXCFSTC small changes Loadlib P001 14 05 09 Version 1 1 PTF0001 YCXCFWRK Create New Variable for Diagnosis Messages Loadlib Security by AXR User October 2010 V2RO Page 39 45 Ly Copyright YCOS Yves Colliard Software GmbH YCPlex YCOS Sysplex User s Guide PTF Date Mod Comment V1 4 07 05 09 Version 1 1 MGOPARM change of Parameters V1 4 07 05 09 Version 1 1 YCXCFASM 0C4 wegen falsche Berechnung neue No Response Meldung Change der Output Parameter V1 4 07 05 09 Version 1 1 YCXCFCMD Change in Parameter new Modify Command DIAGREXX V1 4 07 05 09 Version 1 1 YCXCFMGI Change in Parameter Name Change in Work Area V1 4 07 05 09 Version 1 1 YCXCFMGO Change in Parameter Name Change in Output Parameter Change der WTO wegen AXR address space V1 4 07 05 09 Version 1 1 YCXCFREX change in parameter V1 4 07 05 09 Version 1 1 YCXCFSND Change parameter Output V1 4 07 05 09 Version 1 1 YCXCFSTC YCXCFWRK YCXCFCMD gt Diag REXX Output Dataset V1 4 07 05 09 Version 1 1 YCXCFWRK Create Message Dataset bei System Rexx Fehler Change of Work Area Diagnosis 5 4 Version 1 Release 0 und PTFs PTF Date Mod Comment 00000 30 04 09 Version 1 0 first delivery Trademarks IBM MVS ESA MVS XA Os 390 RACE IN
16. CPlex not already started start YCPlex and retry YXCFO05A PARAMETER ERROR LENGTH OF DATA GREATER nnn Current maximum request length greater than nnn 896 YXCFOO6A TIME OUT NO RESPONSE FROM SYSTEM xxxxxxxx Time out reached default 10 seconds or the defined time out YXCFO07E NO RESPONSE RECEIVED The selected systems OTHER or System Name were not found or no response were delivered YXCFOO8E NOT ENOUGH SPACE IN BUFFER TO HOLD ALL RESPONSES Response parameter area too small YXCFO09A ERROR DURING XCF xxxxx RETURN CODE yyy REASON CODE zzzz General error calling an MVS interface QURY1 error during IXCQUERY MSGO1 error during IXCMSGO NTCCR error during Name Token Create NTCDL error during Name Token Delete Internal error YCPlex will stop all activities User Abend 1118 Review the messages and dump call YCOS support YXCFO10A ACCESS DENIED TO PROFILE xxxxxxxx The SEND and RESP functions of YCXCFMGO are RACF protected authorization not granted review the profiles and access authorities LLT October 2010 V2RO Copyright YCOS Yves Colliard Software GmbH Page 31 45 YCPlex YCOS Sysplex User s Guide 3 5 6 Messages of YCXCFMGI YXCFI02A POST ERROR CODE 8 FROM SYSTEM xxxxxxxx Post Error Code 8 Call YCPlex Support YXCFI03A POST ERROR ERRET FROM SYSTEM xxxxxxxx Post Erret Error Call YCPlex Support YXCFI04A NAME TOKEN ERROR NO RESPONSE FROM SYSTEM xxxxxxxx Name Token for response n
17. Command Time Work normaly until a Stop command is entered o after the Stop command is given the subtasks will be detach and the storage will be freed e YCXCFCMD the subtask of YCXCFSTC will process modify and stop commands Following commands are supported o STOP P MODIFY F SHUTDOWN STOP P YCPlex will be stopped o MODIFY F LOADMODS all YCPLex started task modules will be displayed also their current version and PTF levels o Unknown commands will produce an error message e YCXCFTIM the suubtask YCXCFTIM is designed to prevent abends S522 e YCXCFWRK this subtask will be posted on every SEND request the infor mation request will be forwared to system rexx YCXCFREX e YCXCFMGI this SRB exit routine will be loaded in storage by YCXCFSTC and will be defined as the message exit routine of the XCF Group YCXCFGRP The SRB routine becomes control on SEND requests and on responses following tasks will be executed o SEND the requests will be serialized and put to the message stack YCXCFWRK will then posted October 2010 V2RO Page 6 45 Copyright YCOS Yves Colliard Software GmbH Ze YCPlex YCOS Sysplex User s Guide o RESP on responses the address space and name token of the SEND re questor created thru YCXCFMGO during SEND will be used to copy the response in the defined area address space cross memory and post the waiting address space e YCXCFMGO can be called from any address space but must be authoriz
18. LGT x2d c2x left MSG PARM 2 MSG PREQ substr ycxcfinf 55 8 ZS MSG PDAT substr ycxcfinf 63 work the data queue left copies abcdefghi 90 894 exit 0 2009 change receiving parameter 2009 change return response extract Diagnos length info S Store C sending sending sending sending Length and Data length of Data is END lock System User Id Name Tok Data Prt Requested Function Parameter Data Test with 896 LE y x7 i el Za Wi S ari Wi Wi e SC S 4 5 KE S Figure 7 sample system rexx response YCXCFTST 1 3 2 Sample YCPLEXQY The rexx sample YCPLEXQY can be used to check the sysplex YCPlex query QURY function The rexx can be called if authorized unter TSO and also in batch YCPLEXQY Calling YCPLEXQY with the BATCH parameter will display the JCL needed to run the sample in batch Sample output Men 00548 Line 00000000 Col 001 080 Scroll BROWSE u D Command Ck CK kk ck kk Ck kk Ck Ck kk Ck kk Ck Sk kk Sk Kk kv ko kx ko ko ko ko oko Top of Data Ck CK Ck Ck Ck kk Ck kk Ck Ck Sk Ck kk Ck Sk kk ko Kk Sk ko Mk ko k ko ko ok ko Utilities Compilers Help SYS09217 T124911 RA000 YVES RO1 gt YCplex Group Query YCXCFGRP in Sysplex PERPLEX Responses received 1 System SYSY running YCPlex C YCOS Yves Colliard Software GmbH 2009 09
19. Read the message b Get the NTC of the request c Find the target address space d Uses cross memory to copy the response in the answer area e the YCXCFMGO ECB will be posted 3 YCXCFMGO gets control back a The requestor NTC will be deleted b The next member can be worked at the end of all members c The control goes back the the caller 4 The caller receives the response and can analyze it October 2010 V2RO Page 14 45 Copyright YCOS Yves Colliard Software GmbH 4 YCPlex YCOS Sysplex User s Guide a Return code gt 4 severe error b Return code 4 system not found c Return code 0 the response area is filled i 4 Bytes number of answers ii For every answer 1 8 Bytes system name 2 2 Bytes response length inkl the 2 Bytes length field a 0000 length can be interpreted as a timeout 3 nnn Bytes answer maximum 894 LAT October 2010 V2RO MB Copyright YCOS Yves Colliard Software GmbH Page 15 45 YCPlex YCOS Sysplex User s Guide 1 3 YCPlex samples This chapter presents three examples of calling YCXCFMGO all samples are located in the SAMPLE file or included in the delivered REXX The caller must place in the first 8 bytes of the parameter of a request code this request code is the name of the system rexx which has to be invoked by YCXCFREX on the target system 1 3 1 System Rexx sample YCXCFSND To use this sample YCXCFSND YCXCFMRG and YCXCFTST must be i
20. XCF will transport the request from the sender YCPlex member to the target YCPlex member XCF will post the YCPlex message exit YCXCFMGI 2 The YCXCFMGI message exit a Read the message b serialize Local Lock the work c put the message in a buffer area d the request work ECB will be posted e the serialization will be freed 3 the getmain area was aquired by YCXCFSTC 4 YCXCFWRK receives control a The request will be analyzed and a system rexx request will be created The Rexx YCXCFREX will be called with following parameter i Asynchron ii Without time limit October 2010 V2RO Page 12 45 Copyright YCOS Yves Colliard Software GmbH 4 YCPlex YCOS Sysplex User s Guide iii with TSO environment iv with the RACF environment of the caller serialization Local Lock the request will be deleted from the work area serialization will be freed YCXCFWRK goes back into a wait state 5 The system REXX YCXCFREX gets control a The 2 variablen YCXCFIN1 and YCXCFIN2 a system rexx AXREXX con straint contains the message b the wanted function is called and the result can be provided using the stack The result can be up to 896 byte long including 2 bytes length c System Rexx YCXCFREX call the YCXCFMGO program to send the re sponse back tot he requestor Following parameters are needed i Request RESP ii Target system only the request sending system can be specified as provided from the SEND request
21. XCFMGI COPYRIGHT 2009 10 V2R0 PTFO010 07 05 10 20 YXCFCO4I YCXCFTIM COPYRIGHT 2009 10 V2R0 PTFO010 07 05 10 22 YXCFCO4I YCXCFCMD COPYRIGHT 2009 10 V2R0 PTF0010 07 05 10 08 YXCFCO5I YCXCFMGO COPYRIGHT 2009 10 V2R0 PTF0010 07 05 10 21 YXCFCO4I YCXCFWRK COPYRIGHT 2009 10 V2R0 PTF0010 07 05 10 22 October 2010 V2RO Page 24 45 Copyright YCOS Yves Colliard Software GmbH Ze YCPlex YCOS Sysplex User s Guide 3 4 YCXCFREX System Rexx Diagnosis An output dataset can be created from the YCXCFREX system REXX for diagnostic pur poses it will contain SAY TRACE and errors The current state of diagnosis is obtained using the following command F YCPLEX DIAG YXCFCO8I DIAG OF YXCFCO7I DIAG The diagnostic dataset can be turned on or off by using following command F YCPLEX DIAGREXX ON YXCFCO9I DIAGREXX SET TO ON QI F YCPLEX DIAGREXX OFF YXCFC10I DIAGREXX SET TO OFF Any YCXCFREX call will create an output file with following name hlq YCPLEX sysname exec sysname send Dyymmdd Thhmmss the hlq as given on the started task PARM Default SYS1 Sysname exec the executing system name Sysname send the requestor system name The YCPlex user needs RACF Alter access to the datasets A multi line message can also be activated for the YCXCFREX system REXX for diagnos tis purposes it will produce message YXCFRO1I The current state of diagnosis is ob t
22. YCPlex YCOS Sysplex User s Guide YCPlex Version 2 Release 0 Mod 0 User s Guide YCOS Yves Colliard Software GmbH Fremersbergstr 45 D 76530 Baden Baden Tel D 07221 9708384 Fax D 0322 2374 2352 e Mail ycos ycos de Home http www ycos de October 2010 V2RO Copyright YCOS Yves Colliard Software GmbH YCPlex YCOS Sysplex User s Guide Copyright YCOS Yves Colliard Software GmbH 2009 10 All rights reserved Duplication or disclosure only with explicit approval of YCOS Yves Colliard Software GmbH October 2010 V2RO 1 Copyright YCOS Yves Colliard Software GmbH Page ii YCPlex YCOS Sysplex User s Guide Table of contents 1 YGPlex YCOS SVSDIGX E 5 Ti PEONES NC 5 1 2 YCPlex DIOCOSSIIQ EE 10 1 2 1 Send Requests GEND sse enne enne nnne nnne nnns nnns 10 1 2 2 Receiving the request GEN 12 1 2 3 Receiving the response HEGP rnnt nn nanten nnne n e 14 1 3 COPIE le Kn 16 1 3 1 System Rexx sample VCXCEGND nn nan cnn nc cnn na nnne 16 1 9 2 Sample YGPLEXJQY cincti ridere deo E rand denk Fh va Ek nd naar EF n ista 20 1 3 8 Assembler sample VCXSCEAGNM sss nennen nnne entren 21 2 INSTA de Va coincida 22 Sch STO Started Task ici AAA d eio d RC Ub AA NA 22 cU EET e T e X 22 2 3 A 23 3 OperatiOn im aa aaia iaaa aiaiai 24 3 1 Start of YOPIeX ui ds 24 32 Stop of YOPIK e a nano 24 3 3 Modules Versio
23. ained using the following command F YCPLEX DIAG YXCFC121 DIAG or YXCFC11I DIAG The diagnostic message can be turned on or off by using following command F YCPLEX DIAGRMSG ON YXCFC131 DIAGRMSG SET TO ON or F YCPLEX DIAG YXCFC14I DIAG Diagnosis settings are reset to OFF at the stop of the started task LLT October 2010 V2RO MB Copyright YCOS Yves Colliard Software GmbH Page 25 45 YCPlex YCOS Sysplex User s Guide 3 5 Messages of YCPlex The messages of YCPlex have folling format YXCFx y TE I Info Error Error Numbering l l l l l Module Task Rexx containing producing the message C YCXCFCMD Command Interface l l l l l l T YCXCFTIM Abend 522 exclusion S YCXCFSTC Main Started Task W YCXCFWRK Work Task AXREXX Interface O YCXCFMGO Message Out I YCXCFMGI Message In R YCXCFREX System Rexx Message In Interface D YCXCFSND System Rexx Sample A YCXCFASM Assembler Sample Message Id YXC October 2010 V2RO Page 26 45 Copyright YCOS Yves Colliard Software GmbH Ze YCPlex YCOS Sysplex User s Guide 3 5 1 Messages of YCXCFCMD YXCFCO1A ECB MUST BE ZERO Internal error YCPlex will stop all activities User Abend 1112 Review the messages and dump call YCOS support YXCFCO2E UNKNOWN MODIFY PARAMETER entered modify parameter
24. ed YCXCFMGO is used for sending requests and responses Responses can only be used as Reply to a request The use of the YCXCFMGO interface is subject to a RACF protection SEND requests are protected by following profiles in the class FACILITY o YCPLEX SEND function sysname READ permission is needed to send a SEND request to the selected system The RESP request is protected by following FACILITY profile o YCPLEX RESP Only the user of the YCPLEX started task should get READ permission Following parameters macro MGOPARM can be used o SEND PRM L DS CLA Length REQUEST DS CL4 Request SEND SYS SEL DS CL8 System Name selection nv ALL to alls systems OTHER all other systems X sysname this system PRM NTC DS CL16 reserved PRM PTRR DS CL4 reserved m ORG PRM_PTRR PRM TIMO DS CL4 Time out PRM STCK DS CL8 reserved PRM PARM DS OCLI Request Max 896 e 2 Bytes HH Length of parms e 8 Bytes System Rexx receiving control e up to 886 Bytes request parameter sufficient space for the answers Max 4 896 8 32 systems e 4 Bytes LLLL Number of responses per Response 8 Bytes SYSTEM System name of response 2 Bytes HH Length of response if 0000 Then no response up to 894 Bytes Response if Response starts with YXCFR then Error message from YCXCFREX LLT October 2010 V2RO Copyright YCOS Yves Colliard Software GmbH Page 7 45 YCPlex YCOS Sysplex User s Guide
25. ength field The request can including length field be 896 bytes long 3 the YCXCFMGO program receives control and performs the following actions a the NTC Name Token Callable Services of the started task will be read to get member token this is required to send data over this XCF member b the XCF group will be queried to find out all members within the sysplex c a NTC for this SEND request will be created using the TCB token as name Task Control Block d the request ist send per XCF to the selected target s e YCXCFMGO waits for a response or until a time out occurs the default time out is defined to 10 secondes the MSG_TIMO can be used to change the time out value up to 1440 seconds 4 XCF will send the request over CTC Channel To Channel or CF Coupling Facility to the selected member s LLT October 2010 V2RO Copyright YCOS Yves Colliard Software GmbH Page 11 45 YCPlex YCOS Sysplex User s Guide 1 2 2 Receiving the request SEND YCXCFSTC O Load Message Exit Getmain Buffer 100 Msg Send Req Create Join YCXCFGRP Area System Rexx YCXCFREX Create STC NTC Analyze REXX Variables Attach CMD TIM WRK Call selected Function Parms Response Req RESP Target System NTC Name from SEND Ptr to Response from SEND Store Clock from SEND Response Data CALL YCXCFMGO I Figure 3 receiving the request 1
26. ion AAA A SN V2 0 20 07 2010 new version rd V1 2 29 09 2009 delivery P002 20 05 2009 small changes be P001 14 05 2009 change name of REXX YCXCFMGO E new call YCXCFMGO new YCXCFMGO Parameter K V1 1 07 05 2009 Change parameter Output V1 0 30 04 2009 Wi KOR RR KR KK KK KK IR KK kCkCk IR I I I I I kok ck kckckckckck ck kok ck ckok ck I Number of Systems for response buffer anzsys 12 pl Data to be sent select when arg 1 YCXCFTST then do Test with 896 prm left YCXCFTST copies 123456789 90 894 end when arg 1 then do prm YCXCFRMG MY SEND information end otherwise prm translate arg 1 end prml length prm 2 prm x2c d2x prml 4 prm Target System syst MVSVAR SYSNAME send to this system Wi syst OTHER send to all other systems syst ALL send to all systems xy fe E PARM ASEND Only for YCOS Tests PARM SEND SEND RESP Wi PARM PARM left syst 8 Target System KI PARM PARM left 16 orig NTC TToken PARM PARM left 4 orig Ptr to Resp PARM PARM left 8 orig Store Clock wo length parm 4 1 prml Lgt Position Parameter LLT October 2010 V2RO Copyright YCOS Yves Colliard Software GmbH Page 17 45 YCPlex YCOS Sysplex User s Guide PARM PARM Left prm anzsys 1 896 8 the responses t lgt x2c d2x length
27. is incorrect supports only SHUTDOWN STOP or P or LOADMODS YXCFCO3I STOPPING YCPLEX a stop or modify stop command is entered YCPlex will stop all activity YXCFCO4I YCXCFxxx COPYRIGHT YCOS GMBH jjjj jj VxRy PTFnnnn tt mm jj hh mm Modify LOADMODS command output display of the YCPlex started task modules at tached YXCFCO5I YCXCFxxx COPYRIGHT YCOS GMBH jjjj jj VxRy PTFnnnn tt mm jj hh mm Modify LOADMODS command output display of the YCPlex started task modules loaded YXCFCO6I P STOP SHUTDOWN LOADMODS F modify command unknown list of available commands DIAGREXX will not be listed YXCFCO7I DIAGREXX CURRENTLY ON F modify the DIAGREXX command this option is ON at this time YXCFCO8I DIAGREXX CURRENTLY OFF F modify the DIAGREXX command this option is OFF at this time YXCFCO9I DIAGREXX SET TO ON Command DIAGREXX modify F ON executed the option is now active YXCFC10I DIAGREXX SET TO OFF Command DIAGREXX modify F OFF executed the option is now inactive YXCFC111 DIAGRMSG CURRENTLY ON F modify the DIAGRMSG command this option is ON at this time YXCFC121 DIAGRMSG CURRENTLY OFF F modify the DIAGRMSG command this option is OFF at this time LLT October 2010 V2RO Copyright YCOS Yves Colliard Software GmbH Page 27 45 YCPlex YCOS Sysplex User s Guide YXCFC13I DIAGRMSG SET TO ON Command DIAGRMSG modify F ON executed the option is now active YXCFC14I DIAGRMSG SET TO OFF
28. n Assembler YCXCFASM YXCFAO1I SYSTEM xxxxxxxx RESPONSE XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX System Name up to 40 bytes of responded data YXCFA021 SYSTEM xxxxxxxx NO RESPONSE No response from system XXxxxxxx YXCFA031 YCXCFMGO RETURN CODE 4 NO SYSTEM FOUND YCXCFMGO returned a return code 4 YXCFA04A YCXCFMGO RETURN CODE 8 CATASTROPHIC ERROR YCXCFMGO returned a return code 8 User Abend 1119 LAT October 2010 V2RO MB Copyright YCOS Yves Colliard Software GmbH Page 35 45 YCPlex YCOS Sysplex User s Guide 4 YCPlex Support YCOS Yves Colliard Software GmbH Fremersbergstr 45 D 76530 Baden Baden Tel D 07221 9708384 Fax D 0322 2374 2352 e Mail ycos ycos de Home http www ycos de October 2010 V2RO Page 36 45 Copyright YCOS Yves Colliard Software GmbH Ze YCPlex YCOS Sysplex User s Guide 5 YCPlex Version and Release 5 1 Version 2 Release 0 and PTFs PTF Date Mod Comment V2 0 Planed 31 10 10 Version 2 0 GA General Availability 5 2 Version 1 Release 2 and PTFs PTF Mod Date Comment V1 2 02 10 09 Version 1 2 YCPLex in YCSLOG integriert P004 YCXCFMGO Loadlib 08 10 09 Version 1 2 PTF0004 Support for other Wait Interval P005 YCXCFMGO Loadlib 12 10 09 Version 1 2 PTF0005 Support for Userid propagation P005 YCXCFMGO Loadlib 12 10 09 Version 1 2 PTF0005 Support f
29. nen PTF and Compile of Chile 24 3 4 YCXCFREX System Rexx Diagnose 25 25 M essades of YO EE 26 3 5 1 Messages of YEXCFOMD civ iiec tit ke etae toc AA 27 3 5 2 Messages of YOXGF TIM ts uiii tee coit ni tae 28 3 5 3 Messages of YOXCEST Ci iiie iter iditse rente deb dea pea era aded era eene ya d REY Ide Eee TOO 29 3 5 4 Messages of YCXCFWRK ssssssssssssesesseeneeeen nennen neret rnnt ennt s nnne nes 30 3 5 5 Messages of YOXCFMGO ssssssssssseseeeee nennen ener en nnn nennen ananena nenna 31 3 5 6 Messages of YOXCFMGI ssssssssssseseeseeereeen nennen nennen nentes nnns nnne innen 32 3 5 7 Messages of REXX WCNCEREN eee nnn en terrenis entren 33 3 5 8 Messages of REXX YOXCFSND ccccccocccoconcnononnnnnccconnnnnnnnnnnnn cn nan cc ran nennen nennen 34 3 5 9 Messages von Assembler YCXCFASM ssssssssseeeeneene enne nens 35 4 YGPlex SUpport e 36 5 YCPlex Version and ReleaSe mcccococccocanoconanocananocananonanancnanarcnnnnaconanrrananenanana 37 5 1 Version 2 Release 0 and PTFS eise ees eatur aka t NEES NENEEN 37 5 2 Version 1 Release 2 and bit 37 5 3 Version 1 Release 1 and bit 38 5 4 Version 1 Release 0 und PTFS soon nk oc OR Ro a ar cn o eaa 40 6 let E E m 41 October 2010 V2RO Page i Copyright YCOS Yves Colliard Software GmbH Ze Figure 1 Figure 2 Figure 3 Figure 4 Figure 5 Figure 6 Figure 7 Figure 8
30. nstalled in sys tem rexx copy them to SYS1 SAXREXEC or a concatenation Calling the sample using system rexx e F AXR YOXCFSND o Without parameter the text parameter YCXCFRMG MY SEND information will be used o The response MY RESPONSE hh mm ss hhhhhhh will be delivered e F AXR YOXCFSND YCXCFTST o with YCXCFTST as a parameter the text parameter YCXCFTST 123456789 123 length 894 bytes maximum will be used o the response abcdefghilabcdefghila will be delivered e FAXR YOXCFSND Xxxxxxxx o With Xxxxxxxxx as a parameter the text parameter oooxxxxx will be used this is the name of the called system rexx This one has to be created o currently Request unknown would be delivered October 2010 V2RO Page 16 45 Copyright YCOS Yves Colliard Software GmbH Ze YCPlex YCOS Sysplex User s Guide Sample YCXCFSND REXX YCXCFSND Copyright YCOS Yves Colliard Software 2009 10 V2RO Rr a Se 2 ee ee ee eee eee System REXX Send a request to one or more systems Wi Sample This System Rexx will be called with following commands E AXR YCXCFSND E as Call YCXCFRMG Function es F AXR YCXCFSND YCXCFTST SS Call YCXCFTST Function E F AXR YCXCFSND other Call any other Funct
31. on V1RO YCPlex 40 Version V1R1 YCPlex 38 Version V1R2 YCPlex 37 Version V2RO YCPlex 37 Versionen YCPlex 24 X XCF Cross System Coupling Facility XCF Group YCXCFGRP 6 XCF Member YCXCFGRP 6 Y YCPlex YCOS Sysplex Compile 24 F DIAGREXX 25 F DIAGRMSG 25 F LOADMODS 24 Installation 22 Messages 26 Modify DIAGREXX 25 Modify DIAGRMSG 25 Modify LOADMODS 24 Modules 24 operation 24 Overview 5 Performance 23 processing 10 PTF 24 RACF 7 22 samples 16 Shutdown 24 Start 24 STC 22 Stop 24 Support 36 Version V1RO 40 Version V1R1 38 Version V1R2 37 Version V2RO 37 Versionen 24 YCPLEXQY sample 20 YCXCFASM Messages 35 sample 21 YCXCFCMD Messages 27 Module 6 SEND 11 YCXCFGRP XCF Group 6 XCF Member 6 YCXCFGRP XCF Group SEND 10 YCXCFIN1 YCXCFREX 13 YCXCFIN2 YCXCFREX 13 YCXCFMGI Messages 32 Module 6 Receive RESP 14 Receive SEND 12 SEND 10 YCXCFMGO Messages 31 Module 7 RESP 13 SEND 11 YCXCFREX 9 YCXCFMRG sample 19 YCXCFREX Diagnosis 25 DIAGRMSG 33 Messages 33 Receive SEND 12 REXX 9 2g Copyright YCOS Yves Colliard Software GmbH October 2010 V2RO Page 43 45 YCPLEX YCOS Sysplex User s Guide YCXCFIN1 13 YCXCFIN2 13 YCXCFMGO 9 YCXCFWRK 9 YCXCFRMG Beispiel 9 YCXCFSND Messages 34 sample 16 17 YCXCFSTC Messages 29 Module 6 Receive SEND 12 SEND 10 YCXCFTIM Messages 28 Module 6 SEND 11 YCXCFTST sample 19 YCXCFWRK Messages 30 Module 6 SEND 11 YCXCFREX 9 YXCFAO01I Message 35
32. or Userid propagation YS Copyright YCOS Yves Colliard Software GmbH October 2010 V2RO YCPlex YCOS Sysplex User s Guide 5 3 Version 1 Release 1 and PTFs PTF Date Mod Comment P003 03 08 09 Version 1 1 PTF0003 MGOPARM new request code QURY Sample P003 03 08 09 Version 1 1 PTF0003 YCXCFASM correct work of parms Sample P003 03 08 09 Version 1 1 PTF0003 YCXCFMGO If no TSO Var check for Parameter Loadlib change PUTLINE check new QURY Parameter P002 20 05 09 Version 1 1 PTF0002 YCXCFTST change return response Sample P002 20 05 09 Version 1 1 PTF0002 YCXCFSND small changes Sample P002 20 05 09 Version 1 1 PTF0002 YCXCFMRG change return response Sample P002 20 05 09 Version 1 1 PTF0002 YCXCFREX correct MSG_PREQ Rexx P002 20 05 09 Version 1 1 PTF0002 YCXCFSTJ support a HLQ qualifier for Diagnosis Rexx dataset Sample P002 20 05 09 Version 1 1 PTF0002 YCXCFWRK Correct SETLOCK OBTAIN save Loadlib Change Message Dataset name P002 20 05 09 Version 1 1 PTF0002 YCXCFSTC support a HLQ qualifier for Diagnosis Rexx dataset Loadlib P002 20 05 09 Version 1 1 PTF0002 YCXCFMGI Correct SETLOCK OBTAIN save Loadlib P001 14 05 09 Version 1 1 PTF0001 YCXCFREX new variable YCXCFDIA Diagnose Rexx create REXX Trace on DIAGREXX
33. or during ATTACH of YCXCFTIM ATCMD error during ATTACH of YCXCFCMD ATWRK error during ATTACH of YCXCFWRK NTCCR error during Name Token Create Internal error YCPlex will stop all activities User Abend 1114 Review the messages and dump call YCOS support LLT October 2010 V2RO Copyright YCOS Yves Colliard Software GmbH Page 29 45 YCPlex YCOS Sysplex User s Guide 3 5 4 Messages of YCXCFWRK YXCFWO1A ECB MUST BE ZERO Internal error YCPlex will stop all activities User Abend 1115 Review the messages and dump call YCOS support YXCFWO2A POINTER TO WORK AREA ZERO Internal error YCPlex will stop all activities User Abend 1116 Review the messages and dump call YCOS support YXCFWO3A ERROR DURING XCF xxxxx RETURN CODE yyy REASON CODE zzzz General error calling an MVS interface AXRX1 error during AXREXX Internal error YCPlex will stop all activities User Abend 1117 Review the messages and dump call YCOS support October 2010 V2RO Page 30 45 Copyright YCOS Yves Colliard Software GmbH Ze YCPlex YCOS Sysplex User s Guide 3 5 5 Messages of YCXCFMGO YXCFO01A PARAMETER LENGTH ERROR Parameter Error YXCFO02A PARAMETER REQUEST ERROR SEND RESP The request must be SEND or RESP YXCFO03A PARAMETER SEND TO ERROR The target name is wrong during SEND OTHER ALL or System Name expected during RESP System Name expected YXCFO04A GROUP MEMBER NOT ALREADY ACTIVE ON THIS SYSTEM Y
34. ot found it could be a parameter error or the requestor address space endet before the response has arrived YXCFIO5A ASCB CONTROL BLOCK EYECATCHER ERROR FROM SYSTEM xxxxxxxx ASCB control block not found it could be a parameter error or the requestor address space endet before the response has arrived YXCFIO6A STCK COMPARE ERROR FROM SYSTEM xxxxxxxx Store Clock of SEND and RESP are not correct it could be a parameter error or the requestor address space endet before the response has arrived YXCFI07A ERROR DURING XCF xxxxx RETURN CODE yyy REASON CODE zzzz General error calling an MVS interface STOR1 error during STORAGE OBTAIN MSGI1 error during IXCMSGI NTCRT error during Retrieve of Name Token Call YCPlex Support October 2010 V2RO Page 32 45 Copyright YCOS Yves Colliard Software GmbH Ze YCPlex YCOS Sysplex User s Guide 3 5 7 Messages of REXX YCXCFREX YXCFRO1I Rec hh mm ss hhhhhh Snd dd mm yyyy hh mm ss hhhhhh XXXX System xxxxxxxx User Id xxxxxxxx Resp Ptr xxxxxxxx NTC Token XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX nnn Bytes PARM XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX Rec hh mm ss hhhhhh Message receive time Snd dd mm yyyy hh mm ss hhhhhh Message send date and time xxxx System xxxxxxxx User Id xxxxxxxx XXXX Action SEND Sending System and User Id Resp Ptr xxxxxxxx NTC Token x Response pointer and NTC Token in sending address space nnn Bytes SEND XXXXXXXXXXXXXXXXXXXXXXXXXXXxxxxx
35. r to Response not used Attach YCXCFTIM Store Clock not used Request Data Attach YOXCFW RK CALL YCXCFMGO Wait Figure 2 Send Requests 1 the started task this could be also a batch job YCXCFSTC has to be started it is re quired to use YCPlex services The started task has following functions a the message exit YCXCFMGI is loaded in storage b a buffer able to hold 100 messages will be created c the XCF group YCXCFGRP with a member named Sysname will be creat ed od joined d a name token is created named YCXCFSTC sysname and is holding the member token October 2010 V2RO Page 10 45 Copyright YCOS Yves Colliard Software GmbH 4 YCPlex YCOS Sysplex User s Guide e 3 subtasks are initiated i YCXCFCMD command Interface ii YCXCFTIM abend S522 elimination iii YCXCFWRK send request f the started task goes into a state 2 an authorized assembler program or a system REXX can be used to call the pro gram YCXCFMGO which make a SEND request Following parameters are re quired see MGOPARM Makro a request SEND 4 Bytes b target system 8 Bytes following parameters are allowed i ALL the request will be sent to all members including this system ii OTHER the request will be sent to all other members iii system name the request will be sent to the selected member c the request must pre prefixed by a length field 2 Bytes length including l
36. substr ycxcfinf 53 Length and Data a MSG PLGT x2d c2x left MSG PARM 2 length of Data E MSG_PREQ substr ycxcfinf 55 8 Requested Function 4 MSG PDAT substr ycxcfinf 63 Parameter Data work the data queue MY RESPONSE time L the response FEY exit 0 Figure 6 sample system rexx response YCXCFMRG Sample YCXCFTST REXX YCXCFTST Copyright YCOS Yves Colliard Software 2009 10 AN A AA EE BAV A A ASA AAA MERC eege RUM System REXX Sample System Rexx Request Handler nd get control from YCPLEX YCXCFREX id Di ee Sa a a CS ee ee SS ee ee ee ee ee ae SS E EEEE V2 0 20 07 2010 new version P005 12 10 2009 Support for Userid propagation E V1 2 29 09 2009 delivery SI Yoly October 2010 V2RO Copyright YCOS Yves Colliard Software GmbH Page 19 45 YCPlex YCOS Sysplex User s Guide P003 15 07 Z P002 20 05 P001 14 05 2009 first delivery pom Create a long response Ree eee parse pull ycxcfinf MSG DIAG substr arg 1 1 32 MSG LEN substr ycxcfinf 1 4 MSG INFO substr ycxcfinf 5 4 MSG STCK substr ycxcfinf 9 8 MSG SYSN substr ycxcfinf 17 8 MSG USER substr ycxcfinf 25 8 MSG NTOK substr ycxcfinf 33 16 MSG PTRR substr ycxcfinf 49 4 MSG PARM substr ycxcfinf 53 os MSG P
37. xx length and up to 40 bytes of sended data Debugging information DIAGRMSG YXCFR02A YCXCFMGO Return Code Error during call of YCXCFMGO YXCFRO3A Problem during STCK conversion Error during Store Clock conversion YXCFRO4A Request unknown request code During a SEND request a wrong parameter system rexx name was given YXCFRO5A Response length exceeded number bytes Response exceeds the supported size YXCFRO6A Return Code xx from function yyyyyyyy Error during call yyyyyyyy system rexx Review if the system rexx yyyyyyyy is in SYS1 SAXREXEC or concatenation YXCFRO7A YXCFRO7A no data returned from function yyyyyyyy Error during call yyyyyyyy system rexx Review system rexx yyyyyyyy check if a QUEUE of the response is done Stack is empty LLT October 2010 V2RO MM Copyright YCOS Yves Colliard Software GmbH Page 33 45 YCPlex YCOS Sysplex User s Guide 3 5 8 Messages of REXX YCXCFSND YXCFDO1I Responses received nn System xxxxxxxx nnn Bytes RESP XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX Responses received Number of responses received System xxxxxxxx Response from System nnn Bytes RESP XXXXXXXXXXXXXXXXXXXXXXXXXXxxxxxxxx length and up to 40 bytes of responded data Debugging information YXCFD02A YCXCFMGO Return Code Error during call of YCXCFMGO October 2010 V2RO Page 34 45 Copyright YCOS Yves Colliard Software GmbH Ze YCPlex YCOS Sysplex User s Guide 3 5 9 Messages vo
Download Pdf Manuals
Related Search