SAP Basis Transport Management

You are an SAP Basis administrator managing transport requests, routes, and imports across development, quality, and production landscapes using the Transport Management System (TMS).

What to check first

• Run tp -d SID=<sid> query to list all transport requests in the current system
• Verify the TMS configuration file /usr/sap/trans/bin/TP_DOMAIN_<domain>.PFL exists and contains correct domain settings
• Check /usr/sap/trans/bin/domain.cfg to confirm the transport domain name and system connections

Steps

1. List all transport requests in the current system using tp -d SID=<sid> query and identify those with status "Ready for Import" or "In Transit"
2. Create a transport request via transaction SE09 (non-local objects) or SE10 (local objects) in the source system and collect objects into it
3. Release the transport request in SE09 using the "Release" button—this generates the transport files in /usr/sap/trans/data/ and /usr/sap/trans/cofiles/
4. Configure transport routes using transaction STMS (Transport Management System) > Landscape > System Groups > Routes to define which system each request flows through
5. Import the released transport into the target system using tp -d SID=<target_sid> im <request_id> pf=<profile_path> with the correct import parameters
6. Monitor import progress with tp -d SID=<sid> query request=<request_id> or check /usr/sap/trans/log/ for detailed import logs
7. Handle import failures by checking the log file, resolving conflicts (e.g., in SM30 for table transport errors), and re-importing using tp -d SID=<sid> im <request_id> pf=<profile_path> ignore=
8. Verify successful import by checking the request status in STMS—it should show "Imported" with a green checkmark on the target system

Code

#!/bin/bash
# SAP Transport Management - Request Management Script

# Variables
SID="PRD"
TARGET_SID="QAS"
TRANS_DIR="/usr/sap/trans"
TRANSPORT_ID="DEVK900123"

# 1. Query transport request status
echo "=== Query Transport Request Status ==="
tp -d SID=$SID query request=$TRANSPORT_ID

# 2. Check transport domain configuration
echo "=== Check Domain Configuration ==="
cat /usr/sap/trans/bin/domain.cfg

# 3. List all requests ready for import
echo "=== List All Ready-to-Import Requests ==="
tp -d SID=$SID query | grep "Ready for Import"

# 4. Perform transport import with logging
echo "=== Importing Transport Request ==="
tp -d SID=$TARGET_SID im $TRANSPORT_ID pf=/usr/sap/trans/bin/TP_DOMAIN_

Note: this example was truncated in the source. See the GitHub repo for the latest full version.

Common Pitfalls

• Treating this skill as a one-shot solution — most workflows need iteration and verification
• Skipping the verification steps — you don't know it worked until you measure
• Applying this skill without understanding the underlying problem — read the related docs first

When NOT to Use This Skill

• When a simpler manual approach would take less than 10 minutes
• On critical production systems without testing in staging first
• When you don't have permission or authorization to make these changes

How to Verify It Worked

• Run the verification steps documented above
• Compare the output against your expected baseline
• Check logs for any warnings or errors — silent failures are the worst kind

Production Considerations

• Test in staging before deploying to production
• Have a rollback plan — every change should be reversible
• Monitor the affected systems for at least 24 hours after the change