Expanding CICS volumes on Windows

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:

(0 users)Average rating

Add comments

Document information


More support for:

TXSeries
CICS

Software version:

6.1, 6.2, 7.1, 8.1

Operating system(s):

Windows

Reference #:

1616736

Modified date:

2014-01-10

Translate my page

Machine Translation

Content navigation