Description:
How to use ACTEST XFTP to free datasets hung during FTP processing. It is based on a previous ACTEST procedure but much easier and safer to use.
Solution:
Sometimes during FTP processing, a problem may occur that will cause a dataset to remain allocated to TCPaccess. Generally the only known way to free the dataset has been either to cycle the stack, or use an ACTEST process that was quite cumbersome.
PTF RO22073 introduces a better option called XFTP that runs under ACTEST.
General Information
You can use the ACTEST XFTP command to list active FTP tasks.
Do not detach an FTP task unless you are absolutely sure the task and dataset are hung.
Interactive users may appear to be active for an extended period of time but are actually not holding any resources.
The XFTP command results for interactive FTP users show the last dataset used but the dataset may no longer be allocated.
Basic instructions for implementation and utilization
After applying RO22073, you may need to make some configuration changes depending on what you currently have defined.
SERVICE NAME(NETSTAT) MODULE(STELNET) PORT(24)
APPL NAME(ACTEST) TERMPROF(*) PORT(24)
Unicenter TCPaccess Telnet Server 6.0.0 (STACK1.CA.COM)You will be prompted for your userid and password as this is a restricted command.
Mon, 23 Mar 2009 10:20:21 EST
Enter "NEWS" for current news.
Enter Command Or 'HELP':
Requested Service Is Restricted Please Enter Your Userid: And Password: Server Telnet User USER02 Logged InPlease note that until you have completed login, you will not be able to see what you have typed.
xftpXFTP: List of ALL Active FTP TASK XFTP: A Prolonged Running FTP may Indicate an FTP TASK is Hung XFTP: It may be DETACHED to FREE the Dataset. Use Caution. PDETACH nnnnnnnn [email protected] PTAPGM DSN VOLSER USERID Start D/T 2E0EDF80 FTPSFTDR AUCM0.CSNM3.TESTEXEC NMD019 USER03 21May10:58 2E0EECE8 FTPSFTDR USER01 21May11:19
In this instance, to free AUCM0.CSNM3.TESTEXEC, the command PDETACH 2E0EDF80 would be issued to free the dataset. Do not Detach the PTA unless you are sure the Dataset is hung.
END
Implementation for FTP-only stack
If you are running an FTP-only stack, the implementation will be a bit different.
A stack running FTP-only has no device; it connects to a TCPaccess stack, and the FTP server port listens on the main stack.
However, the dataset is allocated within the FTP stack, so the Telnet port must also be defined within the FTP stack so that the dataset can be freed.
The port for Telnet will also be listening on the main stack.
Changes needed on the FTP stack include
APPS (FTP,STACK,TELNET)This allows the STELNET module to function.
GLOBAL ACBNAME(A03ACC4E) API(*) DNR(* 30)You can also verify this by looking in the JESMSGLG or T01LOG of the main stack for this message
T01VT004I VTAMappl - initialized VTAM Applid (Plu) = A03ACC4EThen look in the startup JCL of the main stack for the SSN parameter:
SOUT=X, <DYNAMIC ALLOCATION SYSOUT CLASS> SSN='AC4E', <ADDRESS SPACE SUBSYSTEM NAME> SRC=, <SUBSYSTEM RECOGNITION CHARACTER>
T00IJ067I Lx=5800,Ssnam=AC4E Appl=T01 Sout=X Jobi=SNSWILMANow define these parameters in the APPCFGxx for the FTP stack:
GLOBAL ACBNAME(A03ACC4E) API(AC4E)
SERVICE NAME(TELNET) MODULE(STELNET) PORT(24)
TELNET PORT(24) PASS(DATA) DEFAULT TERMPROF(GROUP01)
APPL NAME(ACTEST) TERMPROF(*) PORT(24)