Technote (troubleshooting)
Problem(Abstract)
CICS servers (SFS, PPC Gateway) might fail or not start when the CICS logical volume used as a data volume or a log volume has run out of space.
Symptom
You can expand a CICS logical volume backed by a Windows file device
On the Windows platform, you can create a new file device with the %CICSPATH%\etc\fileVol program.
C:\>%CICSPATH%\etc\fileVol
Usage: filevol <file-name> <file-size-in-bytes>
or : filevol <file-name> <file-size-in-kbytes>k
or : filevol <file-name> <file-size-in-mbytes>m
1. Create new physical volume of size 10 MB using filevol command.
-
C:\var>fileVol \\.\C:\var\log1 10m
10 MB is 10485760 bytes.
Set \\.\C:\var\log1 to 10485760 bytes.
2. Initialize the newly created disk and associate with the CICS server abcd.
-
C:\var>tkadmin init disk \\.\C:\var\log1 -server /.:/cics/ppc/gateway/abcd
Initialized disk partition \\.\C:\var\log1
disk size (in pages): 2559
3. Expand physical volume of the CICS server using the following command:
-
C:\var>tkadmin expand pvol -server /.:/cics/ppc/gateway/abcd
log_Pabcd 1 \\.\C:\var\log1 0
4. Check the status of the physical volume changes by using tkadmin query command:
-
C:\var>tkadmin query pvol -server /.:/cics/ppc/gateway/abcd
log_Pabcd
-
Information about physical volume log_Pabcd
All sizes and offsets are in pages. Page Size is: 4 KB
Mapped to logical volume log_Pabcd
chunk size: 64
number of regions: 2
region 0: disk: C:\VAR\log_Pabcd offset: 0 size: 1984
region 1: disk: \\.\C:\var\log1 offset: 0 size: 2496
total size: 4480
5. Expand the logical volume of the CICS server using the following command:
-
C:\var>tkadmin expand lvol -server /.:/cics/ppc/gateway/abcd
log_Pabcd 4480
6. Check status of the logical volume changes by using tkadmin query command:
-
C:\var>tkadmin query lvol -server /.:/cics/ppc/gateway/abcd
log_Pabcd
Information about logical volume log_Pabcd
All sizes and offsets are in pages. Page Size is: 4 KB
size: 4480 chunkSize: 64
Backing physical volumes (only 'clean' and 'dirty' volumes are active):
log_Pabcd (clean)
The volume is currently mounted.
Rate this page:
Copyright and trademark information
IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.