# NWTOC System - Document Index

**Date:** 2026-01-19
**System:** Dataforth DOS Machine Update Workflow
**Status:** COMPLETE

---

## Quick Start

**New to this system? Start here:**

1. Read **NWTOC_COMPLETE_SUMMARY.md** (5 min overview)
2. Read **UPDATE_WORKFLOW.md** (complete guide with examples)
3. Follow **DEPLOYMENT_GUIDE.md** (step-by-step instructions)

---

## Batch Files (Production-Ready)

All files in `D:\ClaudeTools\`:

| File | Purpose | Usage |
|------|---------|-------|
| **NWTOC.BAT** | Download updates from network | `NWTOC` |
| **CTONW.BAT** | Upload local changes to network | `CTONW` or `CTONW COMMON` |
| **UPDATE.BAT** | Backup entire C:\ to network | `UPDATE` |
| **STAGE.BAT** | Stage system file updates | Called by NWTOC automatically |
| **REBOOT.BAT** | Apply system updates after reboot | Auto-generated by STAGE.BAT |
| **CHECKUPD.BAT** | Check for available updates | `CHECKUPD` |
| **STARTNET.BAT** | Start network client (existing) | Called by AUTOEXEC.BAT |
| **AUTOEXEC.BAT** | System startup (existing, template) | Runs on boot |

---

## Documentation Files

### Primary Documentation

| Document | Purpose | Read This If... |
|----------|---------|-----------------|
| **NWTOC_COMPLETE_SUMMARY.md** | Executive summary and quick reference | You want a 5-minute overview |
| **UPDATE_WORKFLOW.md** | Complete workflow guide | You want detailed examples and scenarios |
| **DEPLOYMENT_GUIDE.md** | Step-by-step deployment | You're deploying the system |
| **NWTOC_ANALYSIS.md** | Technical analysis and design | You want to understand the architecture |

### Supporting Documentation

| Document | Purpose | Read This If... |
|----------|---------|-----------------|
| **DOS_BATCH_ANALYSIS.md** | DOS 6.22 limitations and workarounds | You're debugging batch file issues |
| **NWTOC_INDEX.md** | This file - document index | You need to find something |

---

## Common Scenarios - Quick Links

### I want to...

**...understand the system**
→ Read: NWTOC_COMPLETE_SUMMARY.md

**...deploy the system**
→ Follow: DEPLOYMENT_GUIDE.md

**...learn how to use the commands**
→ Read: UPDATE_WORKFLOW.md - "Batch File Reference"

**...troubleshoot network issues**
→ Read: UPDATE_WORKFLOW.md - "Troubleshooting" section

**...rollback an update**
→ Read: UPDATE_WORKFLOW.md - "Rollback Procedures"

**...deploy a new batch file to all machines**
→ Read: UPDATE_WORKFLOW.md - "Scenario 1: Update All Machines"

**...deploy system file updates**
→ Read: UPDATE_WORKFLOW.md - "Scenario 3: Deploy New AUTOEXEC.BAT"

**...understand why something was designed this way**
→ Read: NWTOC_ANALYSIS.md - "Critical Problems to Solve"

**...know DOS 6.22 limitations**
→ Read: DOS_BATCH_ANALYSIS.md or NWTOC_ANALYSIS.md - "DOS 6.22 Limitations"

---

## File Locations

### Source Files (This Directory)

```
D:\ClaudeTools\
├── NWTOC.BAT               # Network to Computer update
├── CTONW.BAT               # Computer to Network upload
├── UPDATE.BAT              # Full system backup
├── STAGE.BAT               # System file staging
├── REBOOT.BAT              # System file update (standalone version)
├── CHECKUPD.BAT            # Update checker
├── STARTNET.BAT            # Network startup
├── AUTOEXEC.BAT            # System startup template
├── NWTOC_COMPLETE_SUMMARY.md    # Executive summary
├── UPDATE_WORKFLOW.md           # Complete workflow guide
├── DEPLOYMENT_GUIDE.md          # Deployment instructions
├── NWTOC_ANALYSIS.md            # Technical analysis
├── DOS_BATCH_ANALYSIS.md        # DOS 6.22 analysis
└── NWTOC_INDEX.md               # This file
```

### Deployment Targets

**AD2 Workstation:**
```
\\AD2\test\
├── COMMON\ProdSW\          # Copy all .BAT files here
├── COMMON\DOS\             # Place *.NEW files here
└── TS-*\ProdSW\            # Machine-specific files
```

**D2TESTNAS:**
```
/mnt/test/                  # Same structure as AD2
T:\ (from DOS machines)     # SMB share of /mnt/test
```

**DOS Machines:**
```
C:\BAT\                     # NWTOC installs files here
C:\ATE\                     # Machine-specific programs
C:\NET\                     # Network client
```

---

## Update Path Flow

```
Admin Workstation (AD2)
    ↓ Place files in \\AD2\test\
D2TESTNAS (NAS)
    ↓ Sync every 15 min (sync-to-ad2.sh)
Network Share (T:\)
    ↓ User runs NWTOC
DOS Machine (C:\)
    ↓ System files? → STAGE.BAT
User Reboots
    ↓ AUTOEXEC.BAT calls REBOOT.BAT
System Updated
```

---

## Quick Command Reference

### On DOS Machine

```bat
NWTOC         # Download and install updates from network
CTONW         # Upload local changes to T:\TS-4R\ProdSW
CTONW COMMON  # Upload local changes to T:\COMMON\ProdSW (all machines)
UPDATE        # Backup C:\ to T:\TS-4R\BACKUP
CHECKUPD      # Check for updates without downloading
```

### On NAS (SSH)

```bash
sudo /root/sync-to-ad2.sh                    # Force sync now
cat /mnt/test/_SYNC_STATUS.txt               # Check sync status
tail -f /var/log/sync-to-ad2.log             # Watch sync log
ls -la /mnt/test/COMMON/ProdSW               # List common files
ls -la /mnt/test/TS-4R                       # List machine files
```

### On AD2 (PowerShell)

```powershell
# Deploy batch file to all machines
Copy-Item "D:\ClaudeTools\NWTOC.BAT" "\\AD2\test\COMMON\ProdSW\" -Force

# Deploy system file update
Copy-Item "C:\Temp\AUTOEXEC.BAT" "\\AD2\test\COMMON\DOS\AUTOEXEC.NEW" -Force

# Check sync status
Get-Content "\\AD2\test\_SYNC_STATUS.txt"

# List deployed files
Get-ChildItem "\\AD2\test\COMMON\ProdSW" -Filter *.BAT
```

---

## Testing Checklist

### Quick Test (5 minutes)

- [ ] Run `CHECKUPD` - should show current status
- [ ] Run `NWTOC` - should update files
- [ ] Verify `C:\BAT\NWTOC.BAT` exists
- [ ] Run `UPDATE` - should backup to network

### Full Test (30 minutes)

- [ ] All quick tests
- [ ] Test CTONW MACHINE upload
- [ ] Test CTONW COMMON upload
- [ ] Test system file update (AUTOEXEC.NEW)
- [ ] Verify STAGE.BAT creates backups
- [ ] Verify REBOOT.BAT runs on boot
- [ ] Test rollback from .SAV files
- [ ] Verify network backup exists

---

## Support Contact

**For questions about:**

- **System design:** See NWTOC_ANALYSIS.md
- **Deployment:** See DEPLOYMENT_GUIDE.md
- **Usage:** See UPDATE_WORKFLOW.md
- **Troubleshooting:** See UPDATE_WORKFLOW.md - "Troubleshooting" section
- **DOS 6.22 issues:** See DOS_BATCH_ANALYSIS.md

---

## Version History

| Date | Version | Changes |
|------|---------|---------|
| 2026-01-19 | 1.0 | Initial release - Complete system implementation |

---

## Document Statistics

**Total batch files:** 8 (6 new, 2 existing)
**Total documentation files:** 6
**Total pages (approx):** 100+
**Lines of code (batch files):** ~1,500
**Lines of documentation:** ~3,500

---

**Quick Navigation:**

- **Start Here:** NWTOC_COMPLETE_SUMMARY.md
- **Workflow Guide:** UPDATE_WORKFLOW.md
- **Deploy System:** DEPLOYMENT_GUIDE.md
- **Technical Details:** NWTOC_ANALYSIS.md
- **DOS 6.22 Info:** DOS_BATCH_ANALYSIS.md
- **This Index:** NWTOC_INDEX.md

---

**Status: COMPLETE - Ready for Deployment**
**Date: 2026-01-19**
